YOUR UFFICIAL RASPBERRY PI MAGAZINE 


The official Raspberry Pi magazine Issue 67 (revised) March 2018 | raspberrypi.org/magpi 


MPUTING 


HARDWARE EMULATION &CEASSIC CODING WIT RASPBERRY P| 


SMART HEARING AID 


Building better audio aids with Raspberry Pi 


MAKE A GEIGER COUNTER 


Prep for fallout with a smart radiation tool 


_ WATCHDOG ROBOT 


a Se re $i The aoe see bot on patrol 


Browse safely and stay private 


> AN ARCADE MACHINE IN A LUNCHBOX online with Tor and Pi-hole 


> USE WII NUNCHUKS TO CONTROL YOUR PI 
CONNECT A PI TO APC WITH GPIO EXPANDER 
> RASPBERRY PI ON DISPLAY AT THE V&A MUSEUM 


Issue 67 e Mar 2018 e £5.99 


| | il 


9 "772051"998001 


i ; cK 


CanakKit Raspberry Pi 3 Ultimate Starter Kit 
Model B | 1 GB RAM | 1.2 GHz | Quad-Core CPU 


> Learn to Code 
> Explore Computing 
> Get started with Electronics 


KiT INCLUDES RASPBERRY Pi 3 AND... 


PREMIUM 
HDMI CABLE 


2.5A 
POWER ADAPTER 


32 GB CLass 10 
MicroSD Carb 


USB MicroSD 
CARD READER 


PREMIUM CASE & 
HEAT SINKS 


QUICK-START GUIDE 


PRE-LOADED 
WITH OPERATING SYSTEM 


* 
' 


GPIO To BREADBOARD ! a ' FULL-SIZE ' ' LEDs ' RESISTORS & 
INTERFACE BOARD ; BREADBOARD . ; PUSH-BUTTONS 
>, , 7 | AOE 
' i i i 1} fl 1 
' _~ ‘ " we ' 

i ' ' ' ' 

) ou 
. + > ‘HARA: @. 
CO r MALE TO MALE & | & & 
q 8 r) MALE TO FEMALE r) i 
Available for worldwide shipping at: 
WWW.CANAKIT.COM 
Raspberry Pi Zero W 


Now available at CanaKit! 


€} Bluetooth’ 


ELECTRONIC KITS ¢ ELECTRONIC PARTS ¢ RASPBERRY PI ¢ ARDUINO 


WELCOME TO 
THE OFFICIAL 
MAGAZINE 


e all had to start somewhere. I started with 
a lovely ZX Spectrum, then an adorable C64, 
and finally an amazing Amiga. 

These computers weren’t retro when | got 
them. They were cutting-edge, well-engineered 
masterpieces packing state-of-the-art technology. 
Just like the Raspberry Pi today. 

But a Raspberry Pi can become a ZX Spectrum, or 
a C64, or an Amiga, or an Acorn BBC Micro or Apple II. 

But why bother when you’ve got all that processing 
power at your fingertips? After all, a Spectrum 
couldn’t run a modern masterpiece like Minecraft. 

Nostalgia plays a part. But there’s still a lot to 
learn from classic computers. The nascent computer 
hardware of the 1980s is, in many ways, easier to 
understand that the modern technology stack. 

There’s something wonderfully glorious about 
revisiting classic computers with a Raspberry Pi. It’s 
the best of the old and the new working together 
in perfect harmony. 

This is the second edition of this magazine. We 
heard from readers who had electrical safety concerns 
about a tutorial called ‘Make a WiFi Desk Lamp’. It 
didn’t meet our standards and, because of the nature 
of the guide, we decided to remove it from circulation. 

We would like to thank the readers who brought 
this to our attention. We are a community magazine 
and could not do this without the support and help of 
the Raspberry Pi community. Thank you! 


Lucy Hattersley 
Editor 
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irefox maker Mozilla has 
launched a new, open 
standard for IoT and 


smart homes called Project Things. 


Mozilla announced that Project 
Things “makes it easy for anyone 
with a Raspberry Pi to build their 
own Things Gateway [to control 
any kind of smart device] directly 
from the web.” 

We asked Ben Francis, Mozilla 


software engineer, for more detail. 


“The Things Gateway is designed 


to bridge existing smart home 
protocols and devices to the ‘Web 
of Things’ using ‘adapters’,” 

he says, to add extra wireless 
protocols to the Pi. 

Ben confirms, “The latest 
version has built-in adapters for 
the Zigbee and Z-Wave protocols 
[as well as] adaptor add-ons for 
devices from brands like Philips 
and TP-Link... We’re calling on 
the community to help us builda 
whole directory of add-ons.” 
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Use the simple web interface to control all your smart devices 
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PROJECT 


Many smart home devices use 
Zigbee or Z-Wave to minimise 
power draw. However, as few 
smartphones have Zigbee or 
Z-Wave hardware, smart home 
apps have to relay information 
via a physical hub unit. These 
hubs tend to be proprietary, 
closed ‘black boxes’ - even worse, 
you might need one for your 
lights, another for your heating 
system, and yet another for your 
multi-room speakers. 

Ben says that Project Things 
aims to “standardise web 
technologies as acommon layer”, 
thus consolidating the need 
for hubs into one open-source, 
customisable and upgradable, 
Raspberry Pi- powered unit. 


Beyond the black box 
Any smart device should be 
compatible with a Things Gateway, 
as Ben clarifies: “Our goal is not 

to create a proprietary Mozilla loT 
platform, but rather help to build 
a World Wide Web of things, much 
like the World Wide Web of pages 
you can browse with Firefox.” 
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MOZILLA PROJECT THINGS 


Things Gateway 


Web Thing API 
(HTTPS+WSS) 


Serial : 


O05 ? 


Ben expounds that by “using the Ben adds that “working towards 
Web Thing Description format and royalty free IoT standards, 
Web Thing API (iot.mozilla.org/wot) with multiple competing 


lol 


we’ re contributing towards implementations, should help to 

+s . “¢: . Above Project Things uses open- 
standardising through the World drive down the certification and eolirecictaidaids lo bind (ode aes 
Wide Web Consortium (W3C).” licensing costs, [both for hardware — competing smart home standards 


To build a World Wide Web 
of things, much like the 
World Wide Web of pages 


THE FUTURE OF PROJECT THINGS 


Project Things was only announced in June 2017, 
so to have working code already just seven 
months later is pretty impressive. But Mozilla isn't 


Interestingly, given Mozilla’s devices and] the software needed stopping there. 
web-based background, Ben to connect them together.” Mozilla software engineer Ben Francis explains, 
confirms that “the rules engine The Project Things GitHub page “The Things Gateway is one part of a framework of 
built into the Things Gateway runs is live (github.com/mozilla-iot) software and services from Mozilla to help create 
locally on the home network.” and you can start making your greater interoperability, privacy, and security on 
Further, “Mozilla providesasecure Things Gateway at iot.mozilla.org. the Internet of Things.” 
tunnelling service to make it safe Mozilla recommends a Raspberry Ben even gave some details of the kinds 
and easy to access the gateway over Pi3, anda few USB dongles to add of thing we can expect as part of the Project 
the internet.” support for Zigbee and Z-Wave. Things framework: “We also plan to provide 


a collection of loT cloud services (starting 
with the secure cloud tunnelling service) and 


a device framework which provides reusable 
software libraries for platforms like Arduino and 
Android Things.” 

The aim is to allow developers to create 
“native web things which connect to the Web of 
Things directly.” 

With open-source software, combined with 
cheap and well-supported hardware such as the 
Raspberry Pi and Arduino boards, Project Things 
could finally bring some harmony to the confusion 
of conflicting smart home standards. 
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Coolest Projects is an 
international event for young 
digital makers aged 18 and under 


There's plenty to do 
at Coolest Projects, besides 
demonstrate your own build 


Kenneth O'Halloran, Coolest Projects 2017 


Images courtesy of: 


— COMES TO THE 


UK 


| CoderDojo event expands 


n international show for 

young digital makers 

to demonstrate their 
projects, CoderDojo’s Coolest 
Projects is coming to the UK for the 
first time this year. 

Coolest Projects International 
will take place at the Royal 
Dublin Society on Saturday 26 
May (coolestprojects.org), while 
Coolest Projects UK is on Saturday 
28 April, at Here East in the 
Queen Elizabeth Olympic Park, 
London (hereeast.com). 

Anyone under the age of 18 and 
currently in primary, secondary or 
further education can enter, either 
as an individual or part of a team 
of up to five members. Projects are 
entered into five broad categories: 
Scratch, Websites, Games + 
Web Games, Mobile Apps, and 
Hardware. The full criteria for each 
are at magpi.cc/2CPqaK5. 

Rosa Langhammer, CoderDojo 
General Manager, Outreach & 
Engagement, explains: “Coolest 
Projects is about bringing an idea 
and sharing it with your peers, no 
matter how big or small or even 
if your project isn’t finished.” 

The entry categories are so 
broad because CoderDojo wants 


“Coolest Projects to be as inclusive 
as possible.” 


Inspiration across 

the nations 

Coolest Projects started “in 2012 
with 19 projects,” Rosa confirms. 
Now Coolest Projects is “an 
international showcase with 

750 young people participating 
last year from 16 countries!” 

Each participant will have their 
own area to set up their project, 
and will “have some free time 
throughout the day to explore other 
projects, as well as some of the cool 
demos and speakers that will be 
joining us for the day,” says Rosa. 

“Tt’s really important to have 
hands-on activities scattered 
throughout,” Rosa continues, 

“so parents, young people, and 
the general public can get hands 
on with science, technology, and 
the arts.” 

Rosa’s favourite Coolest Project 
came from 12-year-old Amy, 
who created a smart beehive 
“with a mission to save bees!” 
Amy uploaded data from her 
hive to hivetool.net, helping 
“international scientists to 
understand why bees are dying.” 
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channels of digi-music” and 
oa even says the Pi “could surely 
manage more.” 


As Yerzmyey explains, the Pi 


doesn’t have a DAC (a digital-to- 
analogue converter) so instead 
you have to record music on 

the processor itself. This limits 


the audio to 11-bit, 40 MHz, but 


that doesn’t seem to have held 
Yerzmyey back. 
Having first started creating 


‘demoscene’ music ona 


NOW That’s What I Call Chiptune! 


emoscene musician 
Yerzmyey has created an 
entire music album on 
a humble Raspberry Pi 2, called 
RPI Zwei. 
Yerzmyey’s music is as full and 
complex as any track you’d hear on 
the radio or Spotify. Yerzmyey tells 
us that “The most complex song 
on the album has 26 independent Yerzmyey blowing out beats in Tokyo in 2014 


ZX Spectrum in the 1980s, 
Yerzmyey used MilkyTracker 
(magpi.cc/2C2HqhH) to 
“program all [the] notes one- 
by-one... Otherwise I use loops 
only when it comes to drum ‘n’ 
bass” and instruments such as 
guitar. Layering notes and loops, 
Yerzmyey “composed the music 
on the Pi and then recorded it all 
directly from the ‘jack’ output.” 
You can listen to RPI Zwei here: 
magpi.cc/2DC1Ym5. 


PI-FRIENDLY 


10.17 TQOUCHSC 


IPS tech for iPad visuals A high-quality five-point 


touchscreen for your Pi 
a makes for a great control 
eading-based electronics specialist panel or kiosk installation 


supplier Inelco Hunter has launched a 

new touchscreen, designed for Raspberry 
Pi. The screen has a 1366x768 resolution and uses 
IPS technology. 

The use of IPS technology over the cheaper TN offers 
“a wider view angle and the full 16.7 million colours,” 
says Inelco Hunter managing director David Bushnell. 

David tells us that demand is for wide viewing 
angles and higher definition; IPS technology also 
offers “a better contrast ratio” and so delivers 
stronger, punchier colours. 


The 10.1-inch screen “is designed to work with all 


models of the Raspberry Pi,” David confirms, with is installed, the five-point touch will work 
standoff pillars and screws provided. automatically,” David explains. 

The screen “supports Raspbian and NOOBs,” The new screen is on sale now, from 
says David. “We are working on drivers for the ?C magpi.cc/2C35bX4, but pricing is based on order 
interface” if you’d rather not use the currently quantity. You can contact Inelco Hunter directly at 
supported USB connection. “Once Raspbian marketing @inelcohunter.co.uk. 
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WORLDS 
TV STATION 


LimeSDR dongle turns a Raspberry Pi 
into a TV broadcast mast 


The stories we shared 
that flew around the world 


ee ee ee | hia t 
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oftware-defined radio us, “We were delighted to see 

(SDR) enthusiast Evariste Evariste’s system.” Ebrahim adds 

Okcestbon has made that he’s also seen “systems to talk 
possibly the world’s smallest TV to the ISS Space Station, LTE [4G] magplee, eters 
Station, using a LimeSDR Mini base stations, [and] IoT platforms. “ BitScope partnered with the Los Alamos National 
dongle, d Raspberry Pi ZEIO, LimeSDR recently released an Laboratory to builda single box containing 750 
and a mini camera module to SDR Starter Kit to make it easy for Raspberry Pi 3s in a cluster configuration 
broadcast a TV signal to a Pi3 with anyone to build similar projects. ~ that's 3000 processing cores! 
USB TV tuner. The Kit uses Grove connectors for 


We wanted people to be able 
to simply pick one up and play 


Evariste showcases his build on the bundled 15 sensors and inputs, 
YouTube (youtu.be/jo6pCleTIzs), and is programmable in Scratch. 
and then explains his setup, which Ebrahim explains, “We wanted 
gets quite technical. people to be able to simply pick one 
Ebrahim Bushehri, CEO of up and play.” 
Lime Microsystems (maker of The Starter Kit costs $249 from 
the LimeSDR Mini dongle), tells magpi.cc/2BZp6WE. magpl.cc/2C1Meef 


For those who don't have the confidence, kit, or time 
to solder a GPIO header to a Raspberry Pi Zero W, 
the organisation has launched the Pi Zero WH -a 

Pi Zero W with pre-soldered header. 


magpi.cc/2COWN1T 


A Raspberry Pi makes for an ideal kiosk PC, but you'll 
need a robust, secure, and dedicated OS to go with 
it - enter Raspberry WebKiosk 7, now updated to 


Evariste’s build might be a bit advanced, but the LimeSDR Starter Kit 
should get you going without any need for soldering or text-based coding Raspbian Stretch. 
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FIGHI-MIC 
MATRIX VOICE BOARD 


Ideal for DIY digital assistant builds 


With an eight-microphone 
array and on-board audio processing, 
the Matrix Voice is a complete digital 
assistant for your Pi 


i es 


atrix Voice’s latest IoT 

add-on, the Matrix Voice, 

has been released in the 
UK - via Newark elementi14, or 
direct from matrix.one. The 
standard circular board (witha 
female header that slots onto the 
Pi’s GPIO pins) costs around £40, 
while the ESP32 version costs 
roughly 645. 

Loaded with eight microphones, 
stereo output (headphone and 3 W 
speaker amplifier), plus a ring of 
18 RGBW LEDs, WiFi, Bluetooth 
4.0 LE, and a dual-core Tensilica 
Xtensa processor, the Matrix Voice 
is compatible with all digital voice 
assistant standards, even “on the 
edge services like Pocketsphynx 


The Life Scientific interviews Raspberry Pi co-founder 


aspberry Pi co-founder 

Eben Upton appeared on 

a recent episode of BBC 
Radio 4’s The Life Scientific, to 
discuss the amazing success of the 


Raspberry Pi and how it came to be. 


Host Jim Al-Khalili asked Eben 
how the name ‘Raspberry Pi’ 
came about — it follows the grand 
tradition of naming computers 
after fruit, with Eben even listing 
“Acorn — very technically a fruit” 
among more obvious names such 
as Apple. 
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“Actually,” Eben continued, 
“it’s such a long tradition 
that there aren’t that many 
[fruits] left.” The other part 
of the name comes, Eben says, 
from Python: “Python has 
always been at the heart of 
everything we’ve done because 
it’s a fantastic introductory 
programming language.” 

Eben also detailed the 
serendipitous role that BBC 
technology correspondent Rory 
Cellan-Jones played in the creation 


and Snowboy,” according to 
Matrix Labs CEO and co-founder 
Rodolfo Saccoman. 

“Developing voice-enabled 
IoT products should not only 
be reserved for those with 
multimillion-dollar hardware 
budgets,” Rodolfo tells us. 

“The open-source Matrix 
Voice empowers makers and 
industrial engineers.” 

Rodolfo confirms that the Matrix 
Voice has been tested with the 
Raspberry Pi 3, Zero, and Zero W, 
and that “we provide beamforming 
and direction of arrival methods” 
with the supporting software, 
which is compatible with Raspbian 
and Android Things. 


Above Eben talks about the birth and 
success of the Raspberry Pi on Radio 4 
show The Life Scientific 


of the Raspberry Pi as we know and 
love it today. 

You can listen to the whole 
program on the BBC Radio 4 
website: magpi.cc/2CPZcSA. 
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PYTHON 
DAY ON 
THE ISS 


Astro Pi Mission Zero Executes 
1771 Scripts in a day 


ith over 2500 entries to the new Astro Pi Mission 
Zero challenge, over 1771 Python scripts made 

it to the International Space Station, hurtling 
through space 250 miles above us. Each script was 
executed in series on Thursday 1 February. 

The Mission Zero challenge was to write a Python 
script that showed the astronauts aboard a message 
on the Astro Pi LED matrix while sensing and 
displaying the temperature of their ISS cabin. Each 
script that passed the rigorous scrutiny procedure (you 
can’t just run any old code in space) was guaranteed to 
run on an Astro Pi aboard the ISS for 30 seconds. 


MCP is in control 

Thankfully, each script didn’t need to be launched 
manually. As David Honess, Raspberry Pi Foundation 
education resource engineer, explains, “We have 

a special program called the MCP (master control 
program); it’s a homage to the 1982 Disney film Tron. 
This is responsible for running all the programs in 
sequence and storing the times, ISS locations, and the 
process exit code.” 

The location of the ISS when executing each script is 
important, as each successful applicant will receive a 
certificate showing the location of the ISS when their 
code executed. 

If you want to spot the ISS (it orbits Earth 15 times a 
day), David recommends pointing your web browser to 
Heavens Above: heavens-above.com. 


PYTHON DAY ON THE ISS 


The two Astro Pi modules - you can emulate them using the 
Sense HAT emulator, developed in partnership with Trinket 
(trinket.io/mission-zero) 
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A recent 
image of 
Italian 
astronaut 
Paolo Nespoli 
using one of 
the two Astro 
Pi modules 
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seek the skills of tomorrow and 
create their future, today. 


The modular laptop with sliding keyboard 


SHR BATTERY 14” FULL HD 18 CUSTOM 
LIFE 1080P SCREEN HINGE PASSIVE COOLING 


BRIDGE 


The modular desktop 


4” FULL HD MODULAR ADJUSTABLE 
1080P SCREEN RAI VIEWING ANGLES 


pi-topPROTO 


© www.pi-top.com 


pi-topSPEAKE! 


© @GetPiTop 


pi-topPULSI 


@ /GetPiTop 


pi-top 
Colors 
Raspberry Pi 3 optional 


AWESOME INVENTOR’S KIT INCLUDED 
20+ projects 
to explore 


Explore beyond the screen and keyboard by 
creating with the all-new pi-top modular Laptop. 


Get started with 20+ inventions in the inventor's 
guide booklet. There are 3 inventor's journeys - 
Smart Robot, Music Maker and Space Race. 


pi-topCEED 


Colors 
Raspberry Pi 3 optional 


pi-topCEED is the plug & play modular 
desktop. It's the easiest way to use your 
Raspberry Pi. We've put what you love 
about our flagship laptop in a slimmer 
Form factor. Join hundreds of code clubs 
and classrooms using pi-topCEED as 
their solution to Computer Science and 
STEAM-based learning. 


Modular 
Accessories 


Stay up to date with our latest news by following our social media 
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pi-top is an award-winning ecosystem designed to make 
experimenting, coding and building electronics, simple, 
affordable and fun. pi-topOS is here to guide you through 
the world of making! 


The OCR® endorsed pi-topOS (Operating system) platform 
comes pre-installed on the SD card shipped with every 
unit. pi-topOS software suite Lets you - browse the web, - 
check emails, - create and edit Microsoft Office 
compatible files. Gain access to dozens of hands-on 
learning Lesson plans with pi-topCODER and have fun 
learning to code with CEEDuniverse! 
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CEEDuniverse 
. 


pi-topCODER has a fully 
integrated coding environment 
Letting you program hardware, 
code in Python and Learn Lots 
of STEAM skills! Our integrated 
test framework gives you the 
ability to assess your own 
understanding as you learn. 


CEEDuniverse 


Learn programming concepts 
through our minigames, 

for example, learn problem 
decomposition by solving 
visual programming puzzles. 
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veryone we know has their 
E own favourite computer. 
Many of The MagPi team 
still love the Sinclair Spectrum; 
others remain loyal to the 
Commodore 64. 

Eben Upton’s eyes light 
up when he talks about his 
Commodore Amiga. 

It was this experience of classic 
computing that led to the creation 
of the Raspberry Pi. This marvellous 
computer was designed to teach 
young people to program. Back 
in the 1980s, kids had to program 
computers in order to use them. 
Consequently, these kids then grew 
up with an innate understanding of 
how computers work. 

The Raspberry Pi is an 
amazing computer that harks 


You can place the Raspberry Pi 
inside its official case, or fit one 
inside a retro-themed case (or 

even an actual retro computer). 


05. MICRO SD CARD 


If you plan to download lots of 
emulated software, then you 
might need a larger microSD card. 
But 8GB should be plenty to set 
up and test a retro computer. 


back to this golden age, and 

it’s capable of emulating the 
very machines that inspired 

it. You can turn a Raspberry Pi 
into a Sinclair Spectrum, ora 
Commodore Amiga, and discover 
(or rediscover) all the classic 
programs, software, and coding 
techniques that kids learnt back 
in the 1980s. 

You can use a Raspberry Pi in 
its original case. Or even put a 
Raspberry Pi inside the case of a 
classic computer. Then you get all 
the love of the original machine, 
with lots of modern features (such 
as HDMI support and networking). 

In this feature we’ll do all of 
that and much more. Get ready to 
go back in time to the golden age 
of computers. 


02. POWERFUL 
PROCESSOR 


The modern ARM processor 
inside a Raspberry Pi is vastly 
more powerful than the chips 
found in older computers. A 
Raspberry Pi can easily emulate 
computers like a Commodore 64 
or Spectrum. 


03. MODERN 
CONNECTIVITY 


A big advantage the Raspberry 
Pi has over older computers 


is Ethernet and wireless 
networking capability. This 
makes it much easier to upload 
files to your retro computer, 
and some hobbyists have even 
created stylised web browsers 
for classic computers. 


04. VIDEO OUT 


Most Raspberry Pi models 
connect to an HDMI television. 
You can also use the 3.5mm 
audio/video jack on a Raspberry 
Pi 2 or 3 (or At or B+) to connect 
AV cables to a classic CRT 
(cathode ray tube) television. 


feature 


RETRO COMPUTING 


RASPBERRY Pl 

We'd recommend using a Raspberry Pi 3 to power 
your emulated computer. But you can use other 
models, like the Pi Zero W. 


HDMI CABLE 

We recommend starting out by hooking your 
Raspberry Pi to an HDMI display using a regular 
cable. This will be easier to set up than going straight 
for a classic CRT option. 


MOUSE & KEYBOARD 

While many older computers didn't use a mouse, 
you'll still need a USB mouse and keyboard to install 
and set up the emulation software. 


hile you can emulate each 
classic computer system 
you fancy separately, 


either using a dedicated bootable 
image or a desktop application, 
we’ve picked RetroPie for our main 
emulation tutorial. 

It’s not perfect, and in some cases 
you'll get better results by installing 
emulators individually, but it’s the 
coolest and easiest way to get a feel 
for the world of emulation. 

RetroPie comes with a huge 
selection of pre-installed and 
optional emulators for almost 
every computer you can think of, 
with the conspicuous exception of 
the BBC Micro, although AdvVMAME 
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provides some functionality 
in this department. 

A Raspberry Pi Zero is powerful 
enough to smoothly emulate 8-bit 
computers, but if you want to 
experiment with more demanding 
software and emulators such as 
DOSBox, we recommend using 
a Raspberry Pi 3. 


>STEP-01 

Download and image RetroPie 
While you can install RetroPie on 
top of Raspbian, the ready-made 
RetroPie distro is easier to use and 
more resource-efficient. Download 
the appropriate version for your Pi 
from magpi.cc/2Eq4H2o0, extract 


RETROPIE IS YOUR ONE-STOP SHOP IF YOU WANT TO EMULATE CLASSIC 
COMPUTERS AND CONSOLES, FROM THE ZX SPECTRUM TQ EARLY IBM PCS 


it, and use Etcher to copy it toa 
microSD card. 

RetroPie is a chunky distro, so 
you’ ll need at least a 4GB card if 
you want to install a few different 
emulators, and we recommend 
opting for a 32GB SD card to 
leave plenty of room for your 
software collection. 


>STEP-02 

Set up RetroPie 

The first time you boot its SD card, 

RetroPie will take a few minutes to 

complete its installation procedure 

before handing over control to you. 
You’ll be asked to configure 

your controllers. You can use a 


CONFIGURING 


keyboard for this, but RetroPie 

is easiest to navigate using a 
joystick or gamepad. Press and 
hold any key on your input device 
of choice to set it up. If you run 
out of buttons, just press and hold 
a key to skip each subsequent 
setting. At the bottom, press the 
button you set as A to complete 
the process. 

If you don’t have a physical 
network connection, your next step 
should be enabling WiFi. You can 
scroll between different emulators 
in RetroPie’s main settings menu 
using the left and right buttons. 

To configure WiFi, move to 
RetroPie menu shortcut (your 
emulator should open on this 
screen) and press button A. Select 
the WiFi option at the bottom of 
the menu. 


>STEP-03 

Add extra emulators 

RetroPie comes preconfigured with 
a number of popular emulators, 
and a few old computers are 
supported out of the box, including 
the ZX Spectrum (via lr-fuse) and 
Amstrad CPC (with Caprice32). 

However, its default set is mostly 
focused on old-school consoles. 

As we’re more interested in classic 
computers than in consoles, you’ll 
want to add a few extras. 

On the RetroPie menu, go to 
RetroPie Setup, then Manage 
packages > Optional packages, 
where you’ll find the original 
version of FUSE (required for 
our Spectrum tutorial on page 
24), DOSBox, Hatari, Vice, and 
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dozens more emulators dedicated 
to everything from arcade 
machines to point-and-click 
adventure games. 

Remember to check the 
operating instructions for each 
emulator at retropie.org.uk/docs. 


>STEP-04 
Find some software 
Most of RetroPie’s emulators 
come fully loaded with the ROM 
(read-only memory) images of the 
computer operating systems you’ ll 
be using, but unless you want 
to write all your own programs 
from scratch — which is certainly 
an option — you’ll have to find 
some software. 
There are plenty of websites 
dedicated to sharing new 
and old software for vintage 
computers. Specialist sites such 
as worldofspectrum.org and 
c64.com are packed with programs 
to download for your emulator. 
While a lot of vintage software 
has been placed in the public 
domain or made open-source by 
its creators, ‘abandonware’ has no 
legal meaning and downloading 
no-longer-supported software 
counts as piracy in many countries, 
including the UK. 


>STEP-05 

Boot to the OS 

RetroPie’s default behaviour is 

to boot directly into the software 
you're trying to run on a given 
emulator, but this isn’t much help 
if you want to access its original 
operating system. 


RETRO COMPUTING 


Left A customisable configurator lets you 
assign input device buttons as needed 


Some of its emulators, like FUSE, 
are installed with a blank file that 
gives you access to its emulated 
Spectrum interface. For others, 
such as the Vice C64 emulator, 
the easiest option is to open the 
Midnight Commander file manager 
from the settings menu, navigate 
to the relevant roms subdirectory 
and create a blank file with the 
appropriate extension. 

For Vice, go to the ~/RetroPie/ 
roms/C64 directory and type 
touch empty.prg. Load from the 
graphical interface and you’ll 
be taken straight to the C64’s 
BASIC interface. 


>STEP-06 

Copy over your files 

The most obvious way to copy 
over your files is to put them 
ona USB stick, plug it into your 
Raspberry Pi, and use Midnight 
Commander, as described above, 
to transfer everything into an 
appropriate directory. 

However, if connected to your 
network, RetroPie also uses 
Samba to share a directory that 
you can copy files to from other 
computers on the network. You 
can also enable the browser- 
based retropie-manager, via the 
experimental package list under 
‘Manage packages’. 


pIeTe 


Above RetroPie provides a polished, 
joystick-friendly front end to access 
your emulators and software 
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of the Commodore Amiga for 
home computing, the two 16-bit 
computers having superseded 
the primitive-by-comparison 
8-bit machines. In addition, the 
ST’s integrated MIDI ports and 
generous memory (anywhere 
between 512kB and 4MB) saw it 
appearing in music production 
studios across the UK. 


EMULATORS ARE AVAILABLE FOR 
EVERYeRET RODC OM Raia) 
CAN THINK OF, BUT NOT ALL OF 
THEM PLAY NICELY Witm TEE 
RASPBERRY PI. HERE ARE OUR 
FAVOURITES, WITH A BIT OF EXTRA 
INFOQ ON HOW TO USE THEM AND 
WHAT TO DO WITH THEM 


bo kn at 


> magpi.cc/2ErcA7S 


The Free Unix Spectrum Emulator 
(FUSE) is one of the longest- 
running and best-supported 
emulator projects around. It’s in 
the Raspbian and Ubuntu MATE 
repositories, so you can install 
it with sudo apt install 
fuse-emulator-sdl. 

Before you get cracking, you’ll 
want some Spectrum operating 
system ROM files (sudo apt 
install spectrum-roms) and 
utilities (sudo apt install 
fuse-emulator-utils). Press 
F1 to access the menu (and its 
full screen in the options menu, 
needed if you run it from a GUI). 

FUSE opens with a perfect 
emulation of the ZX Spectrum 
BASIC, so you can start 
programming straight away. 
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> magpi.cc/2ErIWiC 


The Apple II was always more 
popular in the USA than in the 
UK, but as an early step on the 
hardware development path 
that led to Apple becoming the 
household name it is today, it 
resulted in the creation of some 
of most influential software ever 
made, particularly games. 
LinApple-Pie provides an 
authentic recreation of the 
Apple II and its implementation 
of BASIC, and is available for 
RetroPie and via GitHub to 
download and compile under any 
Linux-based Raspberry Pi OS. 
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> hatari.tuxfamily.org 


The Atari ST spent much of the 
1980s and 1990s as the arch-rival 


The Hatari emulator supports 
USB MIDI adapters, which means 
you can connect MIDI input 
devices like keyboards and output 
hardware like Roland’s SC-55 

with software such as Cubase 

and Notator. 

You can install Hatari from 
Raspbian’s standard repositories 
(sudo apt install hatari), but 
you’ll need ROM images of Atari’s 
TOS (The Operating System), 
which you can learn about at 
magpi.cc/2Em8Fcv and download 
from magpi.cc/2EstrqE. 


> magpi.cc/2EoKAS3 


The BBC Micro isn’t as well 
supplied with emulators as some 
of its more international rivals, 
but although BeebEm hasn’t been 
updated in over a decade, it’s solid 
and stable. However, compiling it 
involves a couple of extra steps. 
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Download beebem-0.0.13.tar.gz 
and the 64-bit, keys, and 
menu_crash patches. Now: 


sudo apt-get install 
libgtk2.@-dev libsd1l1.2-dev 
tar -zxvf beebem-0.0.13.tar.gz 


Before you cd into the directory... 


patch -p® < beebem- 

@.0.13 64bit.patch 

patch -p®@ < beebem-@.0.13- 
keys.patch 

patch -p® < beebem-0.0.13__ 
menu_crash.patch 


cd beebem-@.0.13 
./configure 
sudo make install 


The emulator comes fully loaded 
with operating system ROMs, 
and you can access its settings by 
pressing F12. 


> magpi.cc/2Erd120 


VICE, the Versatile Commodore 
Emulator, is a fantastically 
authentic emulator that not only 
provides a spot-on reproduction 
of the C64 user experience, but 
also the rest of Commodore’s 
8-bit computer range, including 
the VIC-20 and Plus4. 

To install it under Raspbian, 
enter: sudo apt install vice. 
Once running, you can access 
its menus by pressing F12. A huge 
range of clearly labelled settings 

let you do everything from 
Saving programs to connecting 
your emulated computer 

to the internet. 
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> dosbox.com 
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Emulating DOS software on a 
Raspberry Pi can be a challenge, 
simply because of the huge 
range in required specifications 
between MS-DOS’s first release in 
1981 to its final iteration in 2000. 
DOSBox is available in the 
Raspbian repositories, so 

you can sudo apt install 
dosbox and consult the 

excellent documentation 
(magpi.cc/2EmbSJ3) to get 

your vintage software mounted 
and installed. 

DOS has the widest imaginable 
range of software, from DTP 
programs and office suites to 
fractal generators and games. 
However, given the Raspberry 
Pi’s limited processor power, 
you’re best off sticking to software 
released before the mid-1990s. 


> openmsx.org 


The MSX, with its built-in 
Microsoft eXtended BASIC, 
had near-arcade quality 
games and some of the first 
implementations of the MIDI 
electronic music standard. 


RETRO COMPUTING 


While there are a number 
of good MSX emulators out 
there, OpenMSxX is regularly 
updated, extremely faithful, 
and can be found in the standard 
Raspbian repository, so you 
can install it with sudo apt 
install openmsx. 

It even supports MIDI via 
USB adapters and soft synths, 

SO you can use the extensive 
range of MSX music utilities 
archived online. 

OpenMSX comes with an open- 
source operating system ROM, 
but this doesn’t include MSX 
BASIC, so you’ll have to hunt 
down original ROM images for 
your MSX before you can write 
your own software. 
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> magpi.cc/2ErK2ee 


During the late 1980s, the 
Amiga was known for its huge 
range of games and audiovisual 
demos that pushed the limits 
of what Commodore’s systems 
could achieve. 

AmigaOS is still in development, 
with version 4.1 available to 
buy for around £30, while older 
versions of the sort you’ll want 
for emulation are sold by Cloantro 
(amigaforever.com). 

Amiberry is optimised to get 
the best performance out of the 
Raspberry Pi and is available via 
RetroPie, as a bootable image, 
and as source code. If you compile 
it yourself, follow the First 
Installation instructions to get 
all the dependencies it needs 
in place. 
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© DISCOVER ALL THE FUN YOU CAN HAVE 
> WITH'AN EMULATED CLASSIC'COMPUTER 


USBORNE GUIDE To——@ hile playing games and 


home computer world. Electronic 


| BETTER 


Ei (| Go} Fil 
_° hey, 


Above The Usborne Guide to Better BASIC, 
one of the firm's classic computer books 
now available as a free download 


Image Credit: Usborne Publishing 
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W writing software are the 
most obvious uses for 
your virtual vintage computer, 
using old-school software 
provides a unique look and feel 
to more artistic projects, too. 

Back when IBM PCs had nothing 
more than a buzzing monophonic 
beeper to communicate with 
the world, the Atari ST and 
Commodore Amiga were creating 
fantastic polyphonic synth tunes. 

We’ve already mentioned 
the ST’s integrated MIDI ports 
and popularity as a musician’s 
composition, production, and 
performance tool using software 
such as Cubase. 

At the same time on the Amiga, 
MOD files, first created as a 
native format for the Ultimate 
SoundTracker audio composition 
tool, quickly became ubiquitous, 
and their influence is clearly 


audible in modern chiptune music. 


Freeware ProTracker 3.15 is still a 
popular composition tool. 

The Amiga was also the 
graphical champion of the 16-bit 


Arts’ Deluxe Paint was the art 
program of choice for game 
developers and digital artists 
alike. A powerful bitmap graphics 
tool, it was eventually ported 

to MS-DOS, once PC graphics 
technology caught up, and 
produced the original pixel art for 
classic games like The Secret of 
Monkey Island. 
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RENDER 3D GRAPHICS 
if you Bact ee your aanae to 
ray-traced graphics, POV-Ray - 
the Persistence of Vision Raytracer 
— is free and provides old versions 
for download, all the way back to 
its 1992 DOS release. You’ll have 
to get to grips with its text-based 
language for defining the 3D 
objects you wish to render and your 
render times on a Raspberry Pi will 
probably take about as long as they 
would have on a 386 back in the day. 
One of our favourites is 3D 
Construction Kit II (also known as 
3D Virtual Studio) for the Atari, 
Amiga, MS-DOS, and even some 
8-bit systems. Based on the 
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Above 


OOZE (ZX SPECTRUM 128K) 


This isometric adventure-RPG is a short but lovely 


HOME OFFICE exploration of a post-apocalyptic world. 
magpi.cc /2Emarub 
X 1 ASX (ZEVIMODOKI) (MSX) 
1 Z 


Escape destructive robots in this strategic arcade 
blaster with synthesized voice effects 
magpi.cc /2E7BSZg 
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feature 


YOU’LL 
NEED 


> AZX Spectrum 
case with 
keyboard 
membrane 


> Soldering iron 
and solder 


> Ribbon cable 
or wire 


> Sticky pads 
and electrical 
tape to mount 
hardware 


> 2x Pieces of 


stripboard 
large enough to 
he TURN A DEFUNCT ZX SPECTRUM CASE AND MEMBRANE KEYBOARD 
Reeth INTO A NEW HOME AND INPUT DEVICE FOR YOUR RASPBERRY PI 
connectors 
uckily, many ZX Spectrums___ case. There’s space for larger component once everything’s 
> 8x Diodes have made it to 2018 in models in the raised upper area in place. 
(e.g. 1N4148) working order, but the of the case, but the wiring gets 
> 2x Molex ones that weren’t so fortunate more complicated. KEYS TO THE CASTLE 
keyboard can find new lives as a keyboard Always measure carefully, clean The Spectrum keyboard uses a 
membrane and case for the Raspberry Pi. everything, double-check all thin plastic membrane sandwich 
connectors (1x A Raspberry Pi Zero W fits positioning, and make sure you with two layers of electrical 
5-pin, 1x 8-pin) most easily into a Spectrum have enough cable to connect each _ tracks which form a matrix 
> Push-to-make 
momentary 
contact button 2x Spec Psa 
> ZX Raspberry 
Keyboard 
Scanner 
magpi.cc/ : ? el 
2EbikTS GREEN YELLOW WHITE 
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A Pi Zero is perfect for the shallow 
casing of a classic ZX Spectrum. It 
also allows easy access to HDMI 
and power through the case 


The ZX Spectrum lacks function 
keys, so we use this switch to tell 
the Raspberry Pi to remap the 
number keys to F1, F2, and so on 


We can connect the keyboard 
directly to the GPIO header. You 
can use any available I/O pins, 
but see ‘Ribbon solder guide’ box 
(p27) for our suggested layout 


These connect the keyboard 
membrane to the Raspberry Pi. The 


stripboard provides stability and the 


diodes prevent short circuits 


erid of 5x8 tracks. When a key 
is pressed, it creates a circuit 
between two of these tracks. 
Each key ‘lights up’ a unique pair 
of tracks. 

The tracks lead into two ribbon 
cables that go from the keyboard 
assembly to the motherboard. 


Cut two pieces of stripboard, one 
for each connector. Carefully 
work out where to place these 

in the case, as the ribbons from 
the membrane must not be 

put under any stress. Ideally, 
model their positioning on the 
Spectrum’s original motherboard, 


The ribbons are extremely 
delicate and normally the 
first thing to fail on a Soeccy 


The ribbon connectors consist 
of five data lines (KB1) and eight 
address lines (KB2). One wire on 
each will light up per key press. 

The ribbons are extremely 
delicate and normally the 
first thing to fail on a Speccy, 
making keys on the broken 
line unresponsive. Newly 
manufactured replacements are 
available if needed. 

The ribbon cables go to two 
connectors, which we’ll need to 
connect them to the Raspberry 
Pi’s GPIO. You can harvest 
these from a dead Spectrum 
motherboard or buy online. 
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using masking tape to mark 
their position. 

Spectrum keyboard connectors 
are very delicate. If required on an 
old one, manipulate the contacts 
carefully so they make a good 
connection with the ribbon. 

Most importantly, make sure 
you solder them into position 
the correct way around! Only one 
side of the ribbon has its contacts 
exposed and these need to match 
up with the flat side of each 
connector. KB1 connects at the 
bottom, KB2 at the top. 

To support multiple key presses, 
we need to ensure that the current 
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from the address lines doesn’t 
short-circuit, so a diode is used to 
protect each line. When soldering 
the stripboards, make sure you cut 
the tracks between the resistors 
and the diode. 


FUNCTION KEYS 
You’ll also notice another 
component: a button. The 
Spectrum keyboard lacks function 
keys, but you’re going to need 
them to control the Raspberry Pi. 
The Keyboard Scanner utility 
includes an alternative keyboard 


PJ EVANS 


When not volunteering at The 


National Museum of Computing 
or running the Milton Keynes 
Raspberry Jam, PJ can be found 
installing Raspberry Pi devices 
where no-one asked them to be. 
mrpjevans.com 
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mapping mode. When it detects 
a press of our switch, it toggles 
between ‘normal’ mode and a 
second mode that converts the 
number keys into their function 
key equivalent. 


TIME SCANNERS 

To get your Raspberry Pi working 
with the membrane keyboard 
input, we use a Python script to 
scan the keyboard for presses and 
inject them into the kernel. The 
Script outputs a current through 
all address lines (KB2) and drops 
the current to each one in turn 
about 60 times a second. 

If a key is pressed, we can detect 
which data line it’s on, and we 
know which address line was being 
checked, so we know which key 
was pressed. The result is passed 
to a piece of software called uinput, 
which turns it into a Key press. 

The ZX Raspberry Keyboard 
Scanner Script is designed to work 
with RetroPie (see page 18) and 
the FUSE Spectrum emulator, but 
you’ll find instructions for other 
distros on its home page. 


We can use Git to pull down 
the script and its dependencies. 
First, let’s make sure we have the 
essentials to install everything: 


sudo apt install get 
libudev-dev python-dev 
python-pip 

sudo pip install wiringpi 


Now install Libsuinput: 


cd 

git clone github.com/ 
tuomasjjrasanen/libsuinput 
cd libsuinput 

./autogen 

./configure 

make 

sudo make install 


Make sure uinput is loaded 


every time the Raspberry Pi boots. 


Add the following line to /etc/ 
modules-load.d/modules.conf: 


uinput 


You can load it right away 
without rebooting by typing: 


sudo modprobe uinput 
And install Python-uinput: 


cd 

git clone github.com/ 
tuomasj jrasanen/python- 
uinput 

cd python-uinput 

sudo python setup.py build 
sudo python setup.py install 


Download the scanner script: 


cd 
git clone github.com/ 
mrpjevans/zxscanner 


And test it. Carefully connect 
your ZX Spectrum membrane to 
the Molex connectors and run 
the following from the project 
directory (ideally from an SSH 
session on another computer): 


cd ~/zxscanner 
sudo python zxscanner.py 


Now try the keyboard. Each 
key press should produce a letter 
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Looking quite bare - 
compared to the 
original, but with 
buckets more 
power and storage Ww 
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CAPS SHIFT 
ENTER 


SYMBOL 
SPACE SHIFT 


on screen. The SSH session will 
show debug output. Check the 
switch too. 

The script needs to run at 
boot. Start by making the 
file executable: 


sudo chmod +x ~/zxscanner/ 
zxscanner.py 


Then create a service file and 
enter code from startzxscanner. 
service. Our zxscanner.service 
file needs to contain the following 
so the OS knows how to start 
the scanner: 


sudo nano /usr/1lib/systemd/ 
zxscanner.service 


Finally, we enable the service so 
the scanner is always running: 
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sudo systemctl enable 
/usr/1ib/systemd/zxscanner. 
service 

sudo systemctl start 
zxscanner.service 

sudo systemctl daemon-reload 


When used with RetroPie and 
FUSE, a tap on the button will 
cleanly close FUSE, although you'll 
have to configure the emulator 
not to prompt for confirmation. 
A 3-second press will switch the 
keyboard so keys 1-4 become F 
keys (so you can get to FUSE’s 
menu) and 5-8 act as cursor keys. 

A world of ZX Spectrum 
gaming and programming now 
awaits you. You can, of course, 
use your new ZX Raspberry to 
emulate other computers... 
even a Commodore 64. 


8 


Left The Speccy’'s 
keyboard matrix 
allows you to 
detect inputs for ; 


40 keys using just 7 
13 lines. Perfect for c+ 


the GPIO a 


RIBBON SOLDER GUIDE 
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CLASSIC 
COMMUNITY 
BUILDS 


THE GREATEST RETRO COMPUTER PROJECTS 
BUILT USING RASPBERRY PI 


Dom Cresswell of Facebook’s 
RetroPie Makers has built a 
Raspberry Pi-based Amiga 
emulator build running the 
Amiberry emulator inside a new 
A1200 reproduction case. 

“The Raspberry Pi really inspired 
me, and since I had already ordered 
two new A1200 cases from the 
A1200.net Kickstarter campaign, 
the blue one seemed perfect for 
a Raspberry Pi 3, and the colour 
matches our living room, so when 
my wife said she was happy to 
let me start using it as our media 
centre, I really wanted it to be the 
best it could be. 

“T am still waiting for a set of 
black keys to be produced, but 
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I’m very happy with the rest. The 
keyboard works, and is controlled 
by the excellent KeyRah v2 USB 
device and the lights are Conny 
Larson’s Bifrost replacement 
A1200 LEDs, although I had to do 
a bit of work getting them to work 
from the GPIO control voltage. 
“Probably the part Iam 
proudest of, though, is the back 
panel - all done without any 
changes to the original case; I 
bought some blue sheet plastic 
and did a lot of careful Dremel 
cutting to make some panels 
which could just be hot-glued in 
place, complete with the ports... 
the finish looks really great and 
much tidier than I had expected!” 


When both his beloved 
Commodore Plus4 computers 
stopped work, Ian Hill turned to 
his Raspberry Pi to bring them 
back to life. 

“The Plus4 was my first real 
computer, but they tend to 
overheat and burn out some of 
the chips inside, which are not 
available any more, meaning once 
they’re dead, they stay dead. 

“T have two dead Plus4s, so I 
replaced the internals of one of 
them with a Pi Zero, Keyrah V2, 
and Combian64 software. The 
result is aCommodore Plus4 that 
very closely resembles the original, 
and can switch between Plus4, 
C64, and VIC-20 modes, with all 
the available software for all three 
machines built in.” 
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THE THROWBACK: FUZE 


For those who want a retro-styled 
keyboard and chassis, but aren’t 
up for the soldering involved, the 
FUZE (not to be confused with 
the FUSE Spectrum emulator) is a 
perfect compromise. 

Modelled after the classic BBC 
Srey ome Es the cae AS gp pete 


USE YOUR ORIGINAL 
CONTROLLERS 


This is actually the reborn 
Competition PRO Retro made 

by Individual Components 
(icomp.de), but you can do the 
Same project with any old joystick 
or game controller. It seems 

like sacrilege to cut the end off a 
functional controller, so your best 
bet is to order some connector 
ports (or pull some out of a dead 
computer or console). 

There are some great dedicated 
connector boards to hook your 
controller into the Raspberry Pi’s 
GPIO. An alternative is to use 
serial cable and some breadboard 
to connect it and feed into a 
driver module created by the 
RetroPie team. 


on any Pi and is a fantastic ae 
2a to Uae your paren: grammin i. . 


RETRO COMPUTING 


built-in Raspberry Pi 3 and a heap 
of electronics project accessories 
for £169.99 or as a Stand-alone 
case for £90. 

The FUZE BASIC programming 
language, an updated version of 
BBC BASIC, can be downloaded 
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feature 


THE CASE MAKER 


While some Raspberry Pi fans have 
converted favourite computer 
chassis into cases and keyboards, 
Stephen Eddy of RetroPiCases.com 


started remaking his favourites 
*/using a 3D printer and turned 


his passion into a vibrant 
small business. 

“Each case model takes me 
around a month to design and 
produce. Initially I look at the 
source computer models, then 
look for design cues that I can 
incorporate into my own models. 
Because the Raspberry Pi is 
completely different dimensions 
to the original computers and the 
position of the ports are fixed, I use 
the design cues to make the model 
recognisable as a computer from 
the original family.” 


COMMUNITY 
RESOURCES 


RETROPIE MAKERS 
> magpi.cc/2EqwwaE 


KEYRAH USB KEYBOARD DEVICE 
> magpi.cc/2ErTz50 


BIFROST LEDS 
> magpi.cc/2EnXXCa 


IAN HILL’S COMMODORE 
PLUS 4 BUILD 
> magpi.cc/2EpoJdj 


RETROPIE CASES 
> retropicases.com 
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Rolling Subscription 
£4.amonth 


No long-term commitment 


Subscribe for a year: 


£55 
£80 


Exclusive Raspberry Pi offers and discounts £90 
Get every issue first (even before stores) £9 5 


Free delivery to your door 
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FREE 


PIZERO W © 


Pi Zero W 


Pi Zero W case 
with three covers 


USB and HDMI 
converter cables 
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Camera Module 
connector 


SUBSCRIBE ON 


9 Available on the 


« App Store 


bee bed 


CSET IT ON 


> Google Play 
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a SECURITY ROBOT 


> It's IR sensitive 


valeaeal Big Brother on wheels or the potential future of law enforcement: 


eta Josh Starnes’s robot security guard is an arresting sight, 
Pi 3s are used e 
as David Crookes discovers 


> It includes an 
anti-theft GPS 


303D tracker Ithough our city streets are So what is the answer? A lack Inspired by sci-fi movies such as 
s Jesh made packed with CCTV cameras, of resources means flooding the Short Circuit, Evolver, and Star Wars, 
extensive use past reports have suggested streets with police isn’t always Josh got to work on an affordable 
ore Henots that many are either in the wrong economically viable. “But would DIY robot that can trundle around 
EZ-Builder v4 
place or simply don’t work. you be surprised if a robot rolled the streets, operate in cold and wet 
“Someone can throw their hoodie — up, recording or talking to you weather, work well in low light, 
on and hide from a high-mounted while you are up to no good” asks and communicate. He wanted it to 
camera,” argues Josh Starnes. Josh. “T would.” Which is why he record HD video locally and stream 
“People are less likely to misbehave has created a security robot to do via WiFi to a secondary source for 


when someone is physically there exactly that, called Watchdog. online viewing. “I decided to use 
to witness it.” — a Raspberry Pi. It has an excellent 


The bucket top has been tery - on ’ _ The 130-degree camera lenses 
waterproofed to protect the ” , have an easy adjustment to get 
electronics - four Raspberry Pi 3s 1 Ti __ " a clear shot at 10 to 15 feet 
record video and upload it to a PC “ee - 


The Jazzy Select chassis was fitted 
with more aggressive Carlisle 
Knobby tyres and a 10-inch inner 
tube for improved turning grip 


018 \raspber ave 


BRINGING WATCHDOG TO LIFE 


- 


>STEP-O1 


community and it’s moved past 
being a new gadget to a useful tool.” 


Pi spy 

At first, Josh spent time getting 
the chassis right, using the base 

of a Jazzy Select power chair. He 
stripped away unwanted parts 
such as the chair, footrest, original 
Jazzy electronics, and the front 


The Raspberry P1 meant | 
could pick the camera module 


I needed 


anti-tip wheels. He also bought 
a Sabertooth dual 12 A motor 
driver which is optimised for use 
in medium-powered robots and 
radio-controlled vehicles. 
Struggling to find an off-the- 
shelf camera that met all his needs, 
he turned to the Pi 3: “It meant 
I could pick the camera module I 
needed, record to a hard drive, and 
have remote access.” Josh used 
four Pi 3 boards, each connected to 
a camera. “In the event one fails, 
all the others are independent and 
would continue recording.” 
The project uses the Pi NoIR 
Camera Module, which has a 
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WATCHDOG SECURITY ROBOT 


>STEP-02 


5MP sensor, night vision, anda 
130° adjustable-focus lens. Four 

of these are mounted inside the 
robot’s head — the upper half of a 
five-gallon bucket with a screw-on 
lid and a treated plywood bottom. 
Motion and ultrasonic sensors are 
also mounted within the head. 
These enable the robot to detect 
obstacles and movement. 


Easy does it 

With the Raspberry Pi handling 
the video recording and managing 
the broadcast, Josh was able 

to produce a robot that could 
scan its environment, roll up to 
wrongdoers, and record. “I used 
EZ-Robot’s EZ-Builder software. 
They have some wonderful tools 
that allow use of radar-style 
ultrasonic navigation, machine 
vision, and movement controls.” 
He found creating a movement 
routine to be straightforward: 
“EZ-Builder has modules you 
can insert that write complicated 
scripts for you.” 


This gave Josh more time to get 
the Raspberry Pi to record while 
broadcasting. After trying the 
motionEyeOS system but only 
achieving 10 frames per second, 
he turned to Python and wrote 
something himself. Meanwhile, 
he continued to work on the look 
of Watchdog, painting the robot a 
cool gunmetal grey. Today, while 
it’s still a work in progress, it’s 
almost ready for action. 


Above top Josh 
cut off the upper 
five inches of a 
five-gallon bucket, 
using a stepper 

bit to get the 
right-sized holes 
for the cameras 
and sensors 


Above Josh 

picked up this 
Jazzy Select on 
Craigslist and used 
parts from other 
Jazzys to made the 
perfect chassis 
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> openMHA 
can process 
audio signals 
in real-time 


>It can be 
adapted to an 
individual's 
hearing loss 


> Delays 
between input 
and output 
audio is 
below 10ms 


> There's no GUI 
- except for 
fitting the 
amp parts 


» Funding came 
from the 
US National 
Institutes 
of Health 
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When looking for a way of testing hearing aid algorithms outside 
of the lab, a team of researchers realised a Raspberry Pi could be 
a sound investment. David Crookes listens to their idea 


or millions of people 

around the world, hearing 

aids are hugely beneficial. 
Not only do they allow people to 
hear better, they have been shown 
to lower the risk of dementia, the 
potential for loneliness, and the 
likelihood of people withdrawing 
from social situations. 

But while a lot of research has 
gone into developing hearing aids 
over the years, Tobias Herzke, 

a Signal processing engineer at 
HorTech in Oldenburg, Germany, 
says: “There is still a lot of potential 
for improvement, especially in 
acoustically difficult situations.” 

For that reason, the company 
— a spin-off of the University 
of Oldenburg — developed 
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openMHA, which was designed to 
be acommon, portable software 
platform for hearing aid research 
and teaching. “The openMHA 
platform allows for real-time 
audio signal processing with 

low delay,” explains Hendrik 
Kayser, who develops signal- 
processing algorithms for digital 
hearing devices. 

By providing a set of standard 
algorithms to form a complete 
hearing aid, openMHA can process 
the signal from a live microphone 
and perform different tasks such 
as amplification, directional 
filtering, noise reduction, and 
feedback suppression. Testing 
new algorithms is not always 
straightforward, however, which 


Herzke (right) 


is where the Raspberry Pi can come 
into its own. 


Testing times 

“The openMHA software can 
execute on Linux computers in 

a laboratory environment, but 
the sound environment in a lab 
will always differ from real sound 
environments encountered by 
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hearing aid users in real life,” Tobias 
tells us. In the past, this has often 
led to skewed results that do not 
offer a true reflection of how hearing 
aids are used. Yet using ARM-based 
devices such as the Raspberry Pi 
offers a wonderful solution. 

By running openMHA ona 
Raspberry Pi and taking advantage 
of its portable nature, the 
researchers can evaluate new 
algorithms in real-time and in 
realistic outdoor conditions. “It 
has allowed us to implement a new 
algorithm on a mobile device in 
order to find out how it sounds in 
real-time when running around 


We have lowered the entry 
barrier for hearing aid 
algorithm development 


with a hearing aid,” says Tobias. As 
such, it gives research in this field 
a real boost by providing better 
quality and more relevant data to 
work with. 


Loud and clear 

It certainly beats lugging a Linux 
laptop around and it has also 
enabled the researchers to cut 
costs. “Small systems like the 


Below It’s necessary to adapt the 
amplification and compression of the 
‘hearing aid’ to the individual's hearing 
loss. This is done by plugging a monitor 
into the Raspberry Pi and firing up the 
Fitting GUI 
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HEARING AID RESEARCH 


Pi provide decent computing 
capabilities at lower power 
consumption and small size,” adds 
Hendrik, who says the Raspberry Pi 
has the best price-to-performance 
ratio and loves the bonus of on- 
board wireless. “They have allowed 
us to offer a complete, working 
hearing aid signal-processing chain 
and keep the cost below $300.” 

The knock-on effect of this 
has been significant. “By using 
the Pi, we have lowered the entry 
barrier for hearing aid algorithm 
development and evaluation, for 
students at university and amateur 
hearing enthusiasts who lack 


the resources to invest in large- 
scale setups,” says Marc, who is 
leading a hearing search group at 
the university. What’s more, by 
using openMHA for the software, 
Raspberry Pis, and commercially 
available headsets and sound 
cards, the team is able to ensure 
the system is stable and flexible. 

“Low cost, high availability 
through off-the-shelf components, 
mobility, no proprietary solutions, 
community support, and easy 
access to hearing aid software were 
the most important driving points 
here,” concludes Marc. 


Projects 


HEAR THAT SOUND 


= P-l 
Grab a Raspberry Pi 

Originally, portable testing of the op9enMHA software 
platform was carried on on a Linux laptop. Marc 
Rene Schadler, leading a hearing research group at 
University of Oldenburg, felt a Raspberry Pi would 
work better. 


Add a sound card 

Marc took a Raspberry Pi 3, loaded the Raspbian 
Stretch OS on to a 32GB microSD card, snapped up 
an Audio Injector Stereo sound card, and cloned the 
openMHA source code. 


Calibrate and set up 

According to Marc, calibrating the setup before using 
it is vital. “Hearing aid algorithms need to know the 
absolute physical sound of the input,” he says. This 


has been worked into the project. 
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The Touch Board and 
the Raspberry Pi are 
mounted behind the 
canvas, inside the frame 


> The title 
comes froma 
Philip Larkin 
poem 


» The recurring 
bird in the 
canvas 
symbolises 
spirit 


> The original 
drawing was 
a3 metre 
panorama 


> The Touch 
Board costs 
£60 ($85) 
from Bare 
Conductive 


>» Bare 
Conductive 
also makes 
conductive 
paint 
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The work can be mains- 
powered or use a LiPo 
battery, depending on 
where it is displayed 


) THE 


VERSE 


A rare fusion of handicraft and the 
Raspberry Pi has been displayed in the 
world-famous V&A Museum, alongside 
works by Raphael. Sean McManus reports 


To experience the artwork, 
viewers put on the 
headphones to hear the 
accompanying soundtrack 


andering through London’s 

V&A Museum in December, 

you had a chance to see 
works from two major cultural 
movements: the Renaissance, and 
the maker movement. On the wall 
were paintings from 1515, designs 
by Raphael for his celebrated 
tapestries. On an easel was a modern 
work by Stewart Francis Easton that 
combines embroidery, music, and 
the Raspberry Pi 2. “I shared a room 
with Raphael. Just me and Raphael. 
That’s the dream,” Stewart says. 

His work is called The Next Verse, 
and was part of a digital event at 
the gallery. It depicts the cycle of 
life, using scenes of a family along 
a snaking path through the canvas. 
“From childhood to death and round 
again,” explains Stewart. “You begin 
with a father and child and end with 
that child’s son releasing the spirit 
of his father to enable the cycle to 
begin once again.” 

The work is completed by a 
soundtrack. There is a 23-minute 
composition by Michael Tanner, 
performed on a psaltery, a 
stringed instrument often seen in 
medieval paintings. Additionally, 
viewers can trigger sounds. “Each 
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Viewers touch the conductive 
thread of the triangles in the canvas to 
trigger sounds relevant to each scene 


illustrated event has a small 
triangle stitched next to it,” 
reveals Stewart. “The viewer is 
required to touch these triangles 
(one at a time) to trigger the sound 
that corresponds to the storyline.” 


Ambient sounds 

Gawain Hewitt created eight 
sounds for these points in the 
journey. “One of the sounds has 
a bellows playing — almost like 

a broken accordion with static 
sounds and whistling,” says 
Stewart. Another has a recording 
of sounds made at his daughter’s 
school playground. These sounds 
were all required to be able to be 
played along with the original 


soundtrack which plays on a loop. for me is the ability to code in an 
Gawain also carried out the exploratory way,” he says, “so 
technical implementation, which that the act of coding software is 
is based on the Touch Board, made a creative act. I have a background 
by Bare Conductive. Although the in audio engineering, so I find the 


I shared a room with Raphael. 
Just me and Raphael. 


That's the dream 


Adding the thread 


Stewart stitched triangles alongside 


scenes in the canvas, using conductive 
thread. The triangles are connected on 
the back of the canvas with a wire loop 
that goes to the Touch Board. 
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>STEP-02 
Connecting the Touch Board 
The wires from the canvas are soldered 
to the electrodes along the edge of 

the Touch Board. The Touch Board can 


then be connected over USB to the 
Raspberry Pi. 


>STEP-03 

Using the Raspberry Pi 
The Raspberry Pi uses 
software written using Pure 
Data to trigger the spot 
effects and loop the music. 
A Terratec USB sound 

card feeds audio intoa 
headphone amplifier. 


Touch Board can be used to trigger interface and ‘metaphor’ used very Gawain adds: “You do need to plore ements 

MP3s or play MIDI sounds itself, empowering and intuitive.” consider its inherent fragility, headphones, 

it can only play one audio file at and try to avoid crossed lines in interacting with 
, ; c d tive thread ee ne: the artwork is a 

a time. Using the Raspberry Pi ondauc the wiring for better capacitive highly personal 

enabled Gawain to code polyphonic ‘The triangles on the canvas use touch. Also, it can get dirty exPehence 

software, and use high-quality conductive thread to detect touch. | when touched!” 

uncompressed audio files. So, what limitations does it present For the next verse of their 


Gawain wrote the software using asamateriale “From a purely 


Pure Data (Pd), an open-source aesthetic viewpoint it’s the colour 
visual programming language of the conductive thread,” says 
for multimedia. “One of the Stewart. “I think you can only get 
really beautiful things about Pd either grey/silver or gold.” 
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creative collaboration, Stewart 

and Gawain have several works 

in progress, including some that 
might use lights triggered by sound 
running through a Raspberry Pi. 


March 2018 MagPi | 37 


>» The lunchbox 
measures 17 x 
12 x 6.3cm 


>» A5200mAh 
power bank 
supplies the 
juice 


> It'll run for 
about an hour 
per charge 


> Build details 
can be found at 
magpi.cc/ 
2nwQtlE 


> Daniel is 
working on 
four new Pi 
projects 


MINI 


ARCADE 


Never mind a packed lunch, have a Pac-Man lunch 
with this mini retro arcade in a box. By Phil King 


aving already built a full- 

size tabletop-style arcade 

cabinet powered bya 
Raspberry Pi, Daniel Davis wanted 
to make something a little more 
portable to feed his passion for retro 
gaming. So when he acquired an 
old metal lunchbox, the last thing 
on his mind was using it to store 
sandwiches. Instead, he opted to 
pack it with a retro arcade system 
built using a Raspberry Pi 3, Adafruit 
Backpack 5-inch HDMI touchscreen, 
Adafruit Arcade Bonnet, speaker, 
plus an analogue joystick and mini 
arcade buttons. 


“The challenge was sourcing 
arcade buttons and components 
that would fit,” says Daniel. “For 
instance, standard-sized arcade 
buttons were too large to fit inside. 

I also had to take into consideration 
the depth of the screen so that when 
the lid closed, it didn’t smash into 
any of the other components.” 


Neat and tidy 


Rather than simply cramming 
components into the box, Daniel 
wanted to make the system 
organised and easy to use, “so 
that anyone could open it up and 


be familiar with the control layout 
(which mimics that of an NES 
controller or Game Boy).” 

To keep everything looking 
secure, and hide the wiring, Daniel 
3D-printed a screen holder and 
controller board that he’d designed 
ina CAD program. “Once I had all 
the components laid out, I dida 
couple of test prints to make sure 
everything fit, but then I realised 
that I hadn’t designed anywhere 
for the wires to go (especially for 
the screen). So I had to go back and 
redesign the casing to allow room 
for the various wiring.” 


Games are run in 
RetroPie and displayed 
ona 5-inch touchscreen 


The arcade controls and 
speaker are fitted into a 
3D-printed board fora 
neat finish 
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Since the metal box is 
conductive, it had to be 
lined with insulating tape 
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Projects 


The system runs 
the RetroPie retro 
gaming OS ona 
Raspberry Pi 3. 

A software fix was 
required to ensure 
the interface filled 
the screen 


Daniel recalls that a lot of time Raspberry Pi HATs and bonnets 
Was spent measuring, testing, which “made everything a breeze 
and measuring again. “I went to connect. Aside from that, the 
through several different types of available software for the Pi to make 
arcade buttons before I found ones arcade emulation possible is also 
that did the job and fit in sucha something that has become a lot 
small space.” better over the years.” 

Ensuring that the control panel Daniel spent about 20 hours, 
was low enough to allow enough Spread over several weeks, to 
room for the screen when the box complete the build. The end result 


I went through several different 
types of arcade buttons before 
I found ones that did the job 


was closed was another crucial is acute and compact arcade system 
factor: “If the lunchbox couldn’t that’s simple to pick up and play 
close properly, it defeated the whole (youtu.be/h8nhqowESkKg). 
purpose of the project.” Upon being shown the Mini 
Lunchbox Arcade, Daniel’s nephew 
Arcade experience was “really shocked to see what was 
Daniel tells us that his previous inside. He was able to immediately 
experience of building an arcade figure out how to turn it on and start 
cabinet in 2013 helped when playing a game. He did say that if I 
approaching this much smaller could find a way to sell them, all of 
project. since them, the build his friends would buy one and I'd 
process has become a lot easier, make a million dollars. That’s quite 


thanks to the availability of various the endorsement!” 


The joystick, arcade buttons, and 
mini speaker were hot-glued to 
Daniel's 3D-printed controller board 


va 
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RASPBERRY PI 101: BEGINNER'S GUIDE TO WOLFRAM 


Perform advanced mathematics using the powerful program installed with Raspbian 


Raspberry Pi 


Raspbian 
desktop 


The ‘Show/Hide all results‘ button displays extended 


information including plots and expansions 
Free-form input enables 


you to enter mathematical 


equations in linguistic form Step-by-step solutions explain 


how to solve maths problems 


“= 2 m, , Ae aie o Oil ie 
ee ee eee ee ee ee ee eee 


5] limit of sin x as x approaches pir2 5 


Lindt(Sinfa), « => Fis) 1 ¢ 
inter sintel, x -> P42) | setting ratio 
lim ging) ow 1 | In M 
ej | Lees 
r= = | a 
(Plotisintal, (a, -5002655, 8.06044)) 
(x fee -5 
I | 
| 
Series empanains at ees 2, "coe i 
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(*-5)'*5¢(*-3)'~za5(*-3) -l(#-3)) 


ae | 


1 
| Tayi 


40 | MdgPi March 2018 


WOLFRAM MATHEMATICA | Tutorial 


2 The Wolfram|Alpha Knowledge Base offers a wealth of global data 


( default ) 


(=) 
anes = 
(==) 


Mathematica makes it easy to view graphs of equations 


Tutorial 


>2x Wii 
Nunchuks 


> 2 x Nunchucky 
adapters 
magpi.cc/ 
2rzcndj 


> Stripboard: 24 
strips of 13 holes 


> J4HT C4052 
analogue 
multiplexer 
magpi.cc/ 
2rArKCy 


> 16-pin IC socket 


> Bottom-entry 
twin-row header 
sockets 


>4x 68kQ 
resistors 


> 0.1UF ceramic 
capacitor 


Use two Wii Nunchuks to play this unique fast-paced game 


e love mazes here at the Bakery, but steering Wii Nunchuk. But the twist is that you can’t see the 


through one on acomputer has its problems. walls in the maze: if you walk into a wall then you are 
Basically they are either too easy or too instantly whisked back to your starting point. There 
difficult. The Secret Labyrinth is hard but intriguing. are no player turns — just move as quickly as you can — 
It can be played as either a two-player or single- and the maze is constructed so that the path from the 
player game. The players begin at opposite corners of — bottom to the centre is the mirror image of the path 
a maze and have to find the centre by using a series from the top to the centre, so both players face an 
of horizontal and vertical moves controlled bya identical task. 


The Labyrinth with 


the walls temporally 
revealed 


These are the 

Wii Nunchuks, 

the secondary 
part of the Wii 
Remote controller 


The Nunchucky adapter 
allows you to connect the 
Wii Nunchuks to the Pi 


Nunchuks 

The Wii Nunchuk is a cheap and remarkable interface. 
While in this project we will just be using the X-Y 
joystick, the Nunchuk also contains two push-buttons 
and a 10-bit three-axis accelerometer. They are 
interfaced through the I?C bus to the Raspberry Pi, but 
there is a small problem: each device on an I?C bus 
needs to have a unique address and all Nunchuks have 
the same address, fixed in the hardware, that can’t be 
changed. So to get round this problem we have to split 
the bus by steering the [°C signal lines to one Nunchuk 
or the other by using an analogue multiplexer chip. 


>STEP-O1 
Preparing the board 


Take a piece of stripboard 24 strips wide by 13 holes 
high, and break the tracks shown by the dark areas 
with a scalpel or spot face cutter. The dotted lines 
show the positions of the IC socket and the four 
bottom-entry sockets. The board will hang over the 
side of the Pi, not over the printed circuit board. 


labyrinth py 


002. 
003. 
004. 
005. 
006. 


007. 
008. 


0e9. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 


019. 
020. 
@21. 
022. 
023. 
024. 
625. 
626. 
027. 
628. 
029. 
030. 
Q31. 


import sys, random 

from smbus import SMBus 
import RP1.GPIO as io 
import pygame, os, time 


pygame.init() # initialise graphics 


DOWNLOAD: 


magpi.cc/1NqJjmV 


interface Check out Mike's 


pygame.mixer.quit() 

pygame.mixer. init(frequency=22050, 
size=-16, channels=2, buffer=512) 
os.environ[ YEO W ‘l= 
pygame.display.set enc 
pygame.event.set_allowed(None) 


Bakery videos at: 


magpi.cc/1NqJnTz 


pygame.event.set allowed([pygame.KEYDOWN, pygame.QUIT ] ) 


gSpace = 70 # size of square 

gSide = 9 # number of squares per side 
nSquares = gSide*gSide 

screenSize = gSpace * gSide 


screen = pygame.display.set mode([screenSiz 
ze+2],0,32) 

random.seed() 3; centre = (nSquares-1) // 2 
refresh = True ; joyLast = [-1,-1,-1,-1] 


playPos = [@,0,0,0] # current and start pos 
maskFrom = [8,2,1,4] 


e+2,screenSi 


ition 


dirInc = [-1,1,-gSide,gSide] # direction movement 
wallColour = (0,255,255) # for revealed labyrinth 


def Ge 
global refresh, done 
done = False 
initI0() 
init() # load in sound and graphics 
mazeGen() # create maze 


a> , ~ y 
Xx y A, y ~ y 
| j ¥ f 
» 4 b y 
q  f wo 


| yr 


Tutorial 


3V3 
0.1uF 
GND vss 
Vee 7 
Inhibit 6 
SCK 
GPIO3 13 
7c 
GPIO2 aoe 3 
ePIo4 Control A 
Control B 
GPIO17 


>STEP-02 


Underside of the board 


The board will be plugged into 
the Raspberry Pi's GPIO header. 
Only six connections are needed 
electrically, but we have used a 
second four-section of socket 
for mechanical balance. The two 
four-length sections of socket are 
for the Nunchuk adapters to plug 
into. Solder these sockets up 
before commencing 

the wiring. 


Lin 


4052 


10 


16 


14 
15 


SCKO 
SCK1 

SsCK2 
SCK3 


SDAO 
SDA1 


SDA2_ 


SDA3 


Nunchuk 0 


3V3 
SDA 
SCK 


GND 


Nunchuk 1 


3V3 
SDA 
SCK 


GND 


Schematic of the I?C multiplex board 


BYTE 


i? [x6 J x5 [xa Jv Dre Ja ro 


Joystick X - 41to 242 - 139 middle 


Bly] vs] ve] va) ve] 0 [v0 


Joystick Y - 35 to 230 - 129 middle 


- OOOO 


Acceleration X axis - top 8 bits 


, MMMM 


Acceleration Y axis - top 8 bits 


imu 828 | es 7 |e | Aca [ra] 3 822 


Acceleration Z axis - top 8 bits 


gi 21] 820] ave avo} na favo] cz 


Switches and lower 2 bits of acceleration 
[te C Button [2 Z Button 


Figure 2 Registers returned by the Nunchuk 


The multiplexer needs to be analogue because signals 
can go from the Raspberry Pi to the Nunchuk, or from 
the Nunchuk back into the Raspberry Pi. However, all 
we need to do is to set the multiplexer’s select pins 
and talk to the Nunchuk normally, and the selected 
Nunchuk replies. 

The schematic for this board is shown in Figure 1 
and full construction is shown in the step-by-step 
section. The Nunchuk itself when read, sends back a 
block of six bytes; each byte holds different data and 
a map of this data is shown in Figure 2. Note how the 
least significant two bits of the accelerator readings 
are in the last byte. This allows a simple access to an 
8-bit reading as often the last two bits are noise. The 
two push-buttons are in this last byte as well. 


The maze 

The game is set in a 9x9 grid with players starting at 
the upper and lower corners. Due to the symmetry 

of the maze, it is in fact a 9x5 grid that contains the 
maze, but there is no restriction on a player going into 
the other half. Each square has four possible exits and 
these are marked as either blocked or clear in the list 
that holds the definition of the maze. So by checking 
the exit side of a square you want to move from, this 
will either allow free passage or send the player back 
to the start square. The maze is generated by starting 
at the centre and then moving in a random direction 
until a corner is reached. That corner becomes the 
Start position for the player. On each random move, 
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Tutorial 


THE SECRET LABYRINTH 


while 1: 
while not(done): 
checkForEvent() 
if refresh : 
drawScreen(False) # change to True to hide view 
refresh = False 
time.sleep(3.5) # see the walls 
mazeGen() 
done = False 


def drawScreen(laby): 
rSize = gSpace 
pygame.draw.rect(screen, (0,0,8),(8,8,SscreenSize, 
screenSize) ,@) 
#draw Tiles 
for s in range(@,nSquares): 
xp = findX(s) 
yp = findY(s) 
screen.blit(tiles[tilePlan[s]],(xp,yp)) 
#draw grid 
if not(lapy )s: 
for y in range(0,gSide+1): 
pygame.draw. line(screen, (255, 255,0), (gSpace*y,®), 
(gSpace*y, screenSize+2) , 2) 
for x in range(@,gSide+1): 
pygame.draw. line(screen, (255, 255,0),(@,gSpace*x), 
(screenSize+2,gSpace*x) , 2) 


#draw players & prize 

xp = findX(centre) 

yp = findY(centre) 
screen.blit(prize, (xp, yp) ) 
xp = findX(playPos[@]) 

yp = findY(playPos[®@]) 
screen.blit(tux1, (xp, yp) ) 
xp = findX(playPos[1]) 

yp = findY(playPos[1]) 
screen.blit(tux2, (xp, yp) ) 


# draw labyrinth 
if laby : 
for s in range (0,nSquares): 
xp = findX(s) 
yp = findY(s) 
for side in range(0,4): 
if not(maze[s] & 1) : 
pygame.draw. line(screen,wallColour, (xp,yp), 
(xp+rSize, yp), 2) 
if not(maze[s] & 2) : 
pygame.draw. line(screen,wallColour, 
(xp+rSize, yp+rSize) , (xp+rSize, yp), 2) 
if not(maze[s] & 4) : 
pygame.draw. line(screen,wallColour, 
(xp+rSize, yp+rSize), (xp, yp+rSize), 2) 
if not(maze[s] & 8) : 
pygame.draw. line(screen,wallColour, (xp,yp), 
(xp, yp+rSize) , 2) 
pygame.display.update() 
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Tutorial DW Wart: 


>STEP-03 
Wiring up 


>STEP-04 
Wiring up 


the side of the square just gone through is marked 


' Ade - ; . iil ie 
~ ST ag 


as clear and the side of the destination square is also = ay 4 
marked as clear. This allows two-way movement —s # 
between these two squares during the playing , 


phase. The sides are marked as clear by setting the 
appropriate bit in the maze list element for that 
square. This is summarised in Figure 3 (overleaf). 

The side of each square is labelled clockwise 
from the top with the letters A to D. So if the 
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maze-generating program moves from the current 
square through side D, then bit 3 of the maze 
variable is set and the square it moves to (the one 
immediately to the left) has bit 1 for side B also set. 
This then becomes the current square and another 
random movement is made. There are constraints 
to stop the random movements occurring off 

the edge of the playing board, so that the whole 
board is ringed by blocked moves; this simplifies 
the playing logic. When any side of a square is 
cleared, the mirror image of that square and side 
are also cleared. 


The resources 

Each square of the board has a tile background chosen 
at random from a number of tiling strategies. Here 

we have implemented random tiles, diagonal rows of 
the same tile, displaced repeating, and all the same 
tile. Note how diagonal rows are simply displaced 
repeating with the displacement equal to one. We 
found that the tiling scheme as well as adding variety 
to the game also affected the way you play. We chose 
to use two versions of Tux, the Linux penguin, as the 
playing pieces. All tiles and playing pieces should be 
scaled to 72x72 pixels. We again raided the Scratch 
media files to get the sounds for when a player crosses 
a blocked boundary and is sent back to the start. 

A screen dump of a game in progress is shown in 
Figure 4 (overleaf). 


The software 
The software for the project, labyrinth. py, uses our 
favourite Pygame frame work. It uses the smbus 
extension to handle the [?C interface — make sure it 
is enabled in the Interfaces tab of the Raspberry Pi 
Configuration tool. The main function is quite simple 
and consists of an infinite loop repeatedly playing 
different games. The inner while loop just plays 
one game by checking for an event or move and, if 
necessary, redrawing the screen. At the end of the 
game, the maze’s hidden walls are revealed for a few 
seconds before generating a new maze and Starting 
the play again. The drawscreen function takes ina 
Boolean value that determines whether the real walls 
are to be shown or if every square seems to have a 
wall. For very small people, you might want to play 
the game with the walls shown —- simply change False 
to True in the drawscreen function call to do this. 
The mazeGen function is perhaps the most complex 
in this code. It starts off by selecting a tile strategy at 
random and generating a tilePlan list which stores 
the tile number associated with each square. In the 
same loop, the old maze is erased. Then the centre 
Square is set so that it has no barriers around it and 
the random walk clearing the walls is begun from 
the centre until either top corner is visited. That 
completes the maze and ensures at least one path 
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THE SECRET LABYRINTH 


def findX(square): 
return (square % gSide)*gSpace 


def findY(square): 
return (square//gSide)*gSpace 


def initIO(): 
global bus 
io.setmode(io.BCM) 
io.setwarnings(False) 
select = [4,17] 
io.setup(select,io.OUT) 
io.output(select,@) # select nunchuck @ 
print("Initialise I2C") 
if i10.RPI_ REVISION == 1: 


i2c_ bus = @ 
else : 
i2c_bus = 1 


bus = SMBus(i2c_bus) 

for nun in range(@,2): 
bus.write_ byte _data(@x52,0x40, 0x00) 
io.output(4,1) # select nunchuck 1 
time.sleep(0.01) 


def init(): 
global bus,sounds, maze, tuxl, tux2, prize, tiles, tilePlan 
global finish, resetPlayer 
tuxl = pygame.image.load("images/Tux1.png").convert_alpha() 
tux2 = pygame.image.load("images/Tux2.png").convert_alpha() 
prize = pygame.image. load("images/present.png").convert_ 
alpha() 
tiles = [pygame.image.load("images/Tile"+str(t)+".png"). 
convert_alpha() 
for t in range(0,15) ] 
finish = pygame.mixer.Sound("sounds/finish.wav" ) 
resetPlayer = [pygame.mixer.Sound("sounds/Pop.wav"), 
pygame .mixer.Sound("sounds/Rattle.wav" ) | 
maze = [| 
tilePlan = [] 
for sr in range(@,nSquares): 
maze.append(®) # create maze array 
tilePlan.append(@) # pattern of tiles 


def readNck(nunNum): 
# the I2C drivers or something throws up an occasional error - 
this is the sticking plaster 
io.output(4,nunNum) # select the right nunchuck 
time.sleep(@.004) 
ys 
bus.write_byte(0x52,0) 
except: 
print("bus restart") 
time.sleep(@.1) 
initI0() 
bus.write_byte(@x52,0) 
time.sleep(@.002) #delay for Nunchuck to respond 
nck = [((bus.read_ byte(@x52) * 0x17) +0x17) for i in 
range(@,6) | 
return nCk 
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D To square 


Sides of a playing square 
and its attributes 


through it has been generated. We have a version of 
the program in our GitHub repository that uses only 
keyboard keys to move. Finally, the G key will give a 
elimpse of the walls for a second or two - only to be 
used if you are really stuck. 


Taking it further 

You could add a timer and keep a high score of the 
speed of arun. Or you could change the game into 

a turn-based affair. As the maze is symmetrical, 

you could — if you are clever — avoid some walls by 
remembering what your opponent has done. You 
could also change the ending point of the maze 
generation when it reaches the top or bottom row 
instead of a corner. For the more advanced, you could 
generate the mazes by hand, or another program, and 
store several of them in a file and pick the one to use 
at random. This would ensure a much greater variety 
of mazes, and allow you to make quite complex ones, 
but beware of making them too complex. 


D To square B 


| 
| 
| 
| 
| 
| 
| 
| 
) 
To square B | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


| 

| +98 A : 

| : 
| 

| | Bits in the variable “Matrix” 
] 

| 

| 

| D To square B | 

| 

| | 

| O = Blocked 

| 1 = Blocked 

| : 

| : 


—_— ee ee ee 


A game in action; all walls are hidden 
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def mazeGen(): 
global maze, current, last, tilePlan, playPos, 
refresh 


refresh = True 
maskTo = [2,8,4,1] 
thisTile = random.randint(@,14) 
thisMethod = random. randint(@, 3) 
for s in range(@,nSquares): 
maze[s] = @ # clear the maze 
if thisMethod == @: 
tilePlan[s] = random.randint(@,14) # random 
tile 
if thisMethod == 1: 
tilePlan[s] = s % 10 # diagonal lines 
if thisMethod == 2: 
tilePlan[s] = thisTile # all the same but 


different for each maze 


if thisMethod == 3: 
tilePlan[s] = s % 12 # offset lines 
maze[centre] = 15 
current = centre ; last = centre 
while not(current == @ or current == 8): 
blocked = True 
while blocked: 
move = random.randint(@,3) 
direction = dirInc[move] # initial direction 
of move 
test = direction + current 
if test >= @ and test <= (nSquares/2 +gSide/2) 


and test != last: # within the board 
if not(direction ==1 and current % gSide == 

gSide-1) and not(direction ==-1 and current % gSide == 
Q): 

blocked = False 

maze[last] = maze[last] | maskFrom[move] 
# clear exit square 

maze[nSquares-last-1] = 

current = test 

last = current 

maze[current] = maze[current] | 
maskTo[move] # clear entrance square 

maze[nSquares-current-1] = 
Swap(maze[current]) #need to swap bits 


swap(maze[ last] ) 


playPos[@]| = current # player start positions 
playPos[i] = nSquares - 1 - current 
playPos[2] = playPos[@] ; playPos[3] = playPos[i] # 


start positions 


def movePlayer(pn, inc): 
global refresh, playPos, done 
refresh = True 
fromSg = playPos[pn] 
playPos[pn] += dirInc[inc] 
if not(maze[fromSq] & maskFrom[inc]) : 
the way 
playPos[pn] = playPos[pn+2] # back to start 
resetPlayer|pn]|.play() # reset noise 
if playPos[pn] == centre : # winner 


# a wall in 
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Tutorial 


Finish.play() 
refresh = False 
drawScreen(True) 
done = True 


def getMove(): 
global joyLast 
joyNow = [-1,-1,-1,-1] # no move 
for nun in range(@,2): # read both nunchucks 
nun 
y = 2+nun 
bank = readNck(nun) 
if bank[@] > 190: 
joyNow[x] = 1 # move right 
if bank[@] < 60: 
joyNow[x] = @ # move left 
if bank[1] > 190: 
joyNow[y] = 2 # move up 
if bank[1] < 60: 
joyNow[y] = 3 # move down 
if joyNow[x] != joyLast[x] and joyNow[x] > -1: 
movePlayer (nun, joyNow[x]) # move left or right 
if joyNow[y] != joyLast[y] and joyNow[y] > 1: 
movePlayer(nun, joyNow[y]) # move up or down 
joyLast[x] = joyNow[x] 
joyLast|y] = joyNow[y] 


a— 


def swap(value): 

result = (value & 1) << 2 | (value & 4) >»>2 | 
(value & 2) << 2 | (value & 8) >> 2 

return result 


def terminate(): # close down the program 


print ("Closing down please wait") 
pygame.mixer.quit() 
pygame.quit() # close pygame 
os. _exit(1) 
def checkForEvent(): # see if we need to quit 
global refresh 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
getMove() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ESCAPE : 
terminate() 
getMove() 
if event.key == pygame.K_g : #glimpse maze walls 
drawScreen(True) 
time.sleep(2.0) # time to display 
refresh = True # draw over it 
# Main program logic: 


if name == '_main_': 
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MAKE A LALKING 
WEB BROWSER 


For blind people, the internet is at best a challenge. 
With some modifications, the Raspberry Pi can read text content to them 


ow can the internet can be made accessible fill in forms, download music, or listen to the BBC’s 
to those with no sight? Here’s a browser — iPlayer or anything like that. It’s just dandy with 
albeit limited to reading text content — which Wikipedia, though. 


is dedicated to the blind user. Given an internet 
connection, the user has only to enter a search term, use Software setup 


Mechanize up and down cursor keys to select alink, press RETURN, — Use the following commands to install the necessary 
seed en and press CTRL+R to start and stop reading the text. All software in the Terminal or command line: 
2GAhggo this in a Raspberry Pi — and a keyboard, a power supply, 
eSpeak Python and a pair of earphones. That’s right: no screen! sudo apt-get install python-qt4 
package sudo easy_install mechanize 
aerial Before we start sudo apt-get install python-bs4 
oe Note that this browser only reads text from webpages. sudo apt-get install espeak 
Headphones You can enter search terms, you can go to headers or 
links, you can find text within the page. But you can’t Download and unzip the TWB directory from 


magpi.cc/aAIDCi. 
Put the TWB directory in the /home/pi/ directory. 
Add@sh /home/pi/StartTWB.sh to the 
~/.config/Ixsession/LXDE- pi/autostart file. 
am Put the following in the StartTWB.sh file in 
J— the /home/pi/ directory: 


\\ 


~~ 
/ —, Shown here in 
( a soft case, the 
\ Raspberry Pi 
converts text 
to speech 
The user can 
listen to webpage 
text through Ce ee ee | A keyboard is used to 
headphones —JI KYEIJMIE) GAICICIEDY) COQDIGIe) Gc —) (2) navigate pages with 
= a Vik coh = et eh spoken feedback; no 
| need for a monitor 
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An outer case may be used to protect the Raspberry Pi 


#!/bin/bash 

MYPATH=' /home/pi/TWB/' 
MYPROG=' twb. py' 

cd $MYPATH 

sudo /usr/bin/python $MYPATH$MYPROG 


If you want to connect to a wireless LAN, you’ll need a 
screen and mouse to set up the connection (just once). 


Summary of commands 
At startup, you’ll be prompted for a web search term. 

Note: to delete a letter, press the BACKSPACE key, 
not the DELETE key. If you’d rather use the DELETE 
key, look for the # CHOOSE DELETE KEY HERE # line 
in the Main.py file, and comment/uncomment the 
appropriate line. 

Press RETURN to start the search. You’|l hear “The 
first link is...” and the first link. The up and down 
cursor (arrow) keys will announce the other links: 
keep holding the cursor key down to hear the text in 
its entirety, or release it and press again to move on to 
the next link. 

When you’ve found a link to follow, press RETURN 
and wait to hear “Ready”. Press CTRL+R to start 
speaking; press it again to stop. While speech is 


stopped, press CTRL+tH to list headers, use cursor keys 


to hear them, and RETURN to select one. 

Similarly, CTRL+L lists links on the page; again, use 
cursor and RETURN keys to select one. If you can’t 
find a useful header or link, press ESC and you’ll be 
returned to the read mode. To find text on the page, 
press CTRL+tF and enter the search text. Repeated 
presses of CTRL+F will find later occurrences of the 
text, or allow entry of a different search term. 

When not reading, the right and left cursor keys 
move forward and backwards by a word, speaking 
the word, from the beginning of the sentence being 
spoken. SHIFT + left cursor moves back a sentence; 
SHIFT + right cursor moves forward a sentence. 

CTRL+S lets you enter a web search term. In any 
mode, CTRL + up cursor will increase the volume, and 
CTRL + down cursor will reduce it. Similarly, SHIFT + 
up cursor will increase the speed, and SHIFT + down 
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cursor will decrease it. To close down the browser, 
press SHIFT+CTRL+Z. 


DOWNLOAD: 


Under the bonnet 
When entering a web search string (or looking for 
text on a webpage), the key pressed is spoken — for 
speed, we store WAV files for each letter — hence the 
Sounds directory. A powerful module called Mechanize 
simplifies access to the web, in particular making it 
easy to extract links and go to those links. Having 
downloaded HTML from a site, we add markers to 
identify headers, and insert ‘.’ at line, paragraph, 
and table HTML codes. The Beautiful Soup module 
helps with extracting text. We split the text into a list, 
breaking wherever there is a ‘.’. This presents the text as 
a series of, well, let’s call them sentences. The text of a 
webpage is spoken using the eSpeak speech synthesizer. 
Ideally, we’d set eSpeak going, speaking text, and 
stop it if we missed a word, back up a few words, 
and listen again. Unfortunately, this seems to be 
impossible with eSpeak on a Raspberry Pi: the sound 
breaks up and becomes unintelligible after a few 
seconds. Could we write the eSpeak output to a file 
and play the file? Yes, but if we send all the text from 
a webpage to such a file then that leaves no way 
of knowing where in the text we’ve stopped: if we 
wanted to hear a word again, we’d have to plough 
through all the stuff that’s already been spoken. 
That is why we break the text into sentences. We can 
stop — and restart — the text at any point. If we want to 
hear a word again, stop the speech and the right cursor 
key will speak words, starting at the beginning of the 
current sentence. 
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PROGRESS 


The Raspberry Pi handles the conversion of text in webpages to speech 
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sue BILL BALLARD 


Billis a retired physicist and former 
Radiological/ Nuclear Countermeasures 
Program Manager who got back to his 
programming roots to find fun things to 
do with his ten Raspberry Pis. 
github.com/wpballa 


= DISPLAY 


2ejN6sk 
> MightyOhm . ° . . . . 
waeremes § = 1is project connects a MightyOhm Geiger counter to a Pimoroni 
waeweee § Scroll pHAT display for real-time radiation measurements 
2Gc4CNT 
> Geiger counter he MightyOhm Geiger counter is a great DIY immediately. Initialise Raspbian with raspi-config 
case to protect project, and there is a simple way to connect to the proper Internationalisation Options (time 
hiph voltaas it to a Raspberry Pi for data logging and zone, keyboard, wireless country code, etc.), change 
magpi.cc/ displaying with a Pimoroni Scroll pHAT. The code the default password, and set the host name in 
2GejFQU supports either the newer HD Scroll pHAT or the older Advanced Options to something like ‘geiger’. Make 
> 5V USB power version with a simple variable change at the start of sure that you enable [2C in the Advanced Options 
supply the Python program. of raspi-config, and SSH if you will be connecting 
> Pimoroni Scroll remotely. Next, edit: 
pHAT HD Software setup 
oye Download and install the latest version of Raspbian sudo nano /boot/cmdline.txt 
Lite (magpi.cc/2ejN6sk) on your microSD card using 
any of the excellent instructions in the Raspberry ...and remove: 
Pi Forum. If you copy your wpa_supplicant.conf 
file to the boot partition before the first startup, console=serial@, 115300 


your wireless network connection will be active 


Pe oe Sea) oe , a 


A typical graph of ' 
background radiation ae Te 
. a Zitz 
=ZZ2=2 


You can use either 
an original Scroll 
pHAT or an HD one 


The assembled 
Geiger counter 
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...from the line. Save, then exit the file and reboot 
the Raspberry Pi. Now you should do the usual update 
and upgrade to the operating system: 


sudo apt-get update && sudo apt-get 
upgrade -y 


Next, install the Python pip and scrollphathd 
applications (just leave off the ‘hd’ if using an older 
Scroll pHAT): 


sudo apt-get install python3-pip 
python3-scrollphathd 


Finally, install pySerial and flask: 
sudo pip3 install pySerial flask 


...and you are all set. 

Download the geiger.py file from GitHub 
(magpi.cc/2Foqfzl) and customise it for your desired 
log file location and your Scroll pHAT version (HD = 
True or False). 


Hardware setup 

Assuming you have already assembled the Geiger 
counter with the MightyOhm instructions, you 
only need to solder the header to the Scroll pHAT 
and connect a few wires. Optionally, you can use 
an extra-tall 2x20 stacking header so you can use 
a connector. To connect the pHAT to the Raspberry 
Pi, you need to solder three wires to the Scroll pHAT 
corresponding to GPIO physical pins 6, 8, and 10. 
Pin 6 (GND) connects to the Geiger counter’s J7 
connector pin 2, pin 8 (GPIO 14) connects to the J7 
pin 4, and pin 10 (GPIO 15) connects to the J7 pin 5. 


Feel free to use a connector rather than direct wiring. 


Run it 


Connect the Pi to power, then turn on the Geiger 
counter (mute it if you wish, using the push-button). 
Log in and launch the program with: 

python3 geiger.py & 

The display should start showing the uncalibrated 
radiation level in microsieverts per hour, scrolling 
across the screen until you kill the process using: 
kill -9 PID 

...where PID was the number shown when you 
initially launched the program. Alternatively, 
you can use: 
ps -ef | grep geiger 

...to find the PID of the geiger.py process. 
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SIMPLE P! GEIGER COUNTER DISPLAY 


geiger py >PYTHON 3 


#! /usr/bin/python3 


DOWNLOAD: 
magpi.cc/2Foqfzl 


# set this line according to your version of 
the scroll pHAT 
HD = True # set to true for HD version, false for old version 


import serial 

import time 

if (HD): 

import scrollphathd 

from scrollphathd. fonts import font5x7 
else: 

import scrollphat 

fname = "/home/pi/geiger.csv" 

# open the mightyohm geiger counter terminal 

ser = serial.Serial('/dev/ttyAMA@', baudrate=96@0) 

# initialize scrollphathd or scrollphat 

if (HD): 

scrollphathd.set_brightness(@.2) 
scrollphathd.rotate(18@) 
scrollphathd.clear() 

else: 

scrollphat.set_brightness(32) 
scrollphat.set_rotate(True) 
scrollphat.clear() 

# read each line of input, reformat byte to string and write to file 

while True: 

try: 
lin=ser.readline() 
line=lin.decode('utf-8').split(',') 
outs = line[5] + line[4] 
if (HD) : 
scrollphathd.clear() 
scrollphathd.write string(outs, x=1, y=0, font=font5x7) 
(buf1, buf2) = scrollphathd.get_buffer_shape() 
for i in range(buf1): 
scrollphathd.show() 
scrollphathd.scroll() 
time.sleep(@.1) 
else: 
scrollphat.clear() 
scrollphat.write_string(outs, 11) 
len = scrollphat.buffer_len() 
for i in range (len): 
scrollphat.scroll() 
time.sleep(@.1) 

# now write to file, close each time in case you stop the program 
geig = open(fname, ‘a') 
geig.write(lin.decode( ‘utf-8')) 
geig.close() 

except (KeyboardInterrupt, SystemError, SystemExit): 
if (HD): 
scrollphathd.clear() 
else: 
scrollphat.clear() 
geig.close() 
ser.close() 
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BRIAN BEUKEN 


Very old game programmer now 
teaching very young game programmers 
a lot of bad habits at Breda University of 
Applied Science in Breda NL. 
scratchpadgames.net 


NEVER 
BLAME THE 


MACHINE... 


Let's be 
square(ish) 


ON THE RASPBERRY PI 
PART 03 


After our setup of systems, it’s time to get some graphics sorted out 


e had to plough through a lot of tech stuff last Time for some C/C++ foundations 


time, but we still have a tiny bit more to do All programming, regardless of the language, is 
and need to make a few additions so we can about manipulating data, usually represented by 
' cede cat start to build up a framework for a game. You should variables, based on various conditions or needs, and 
get seed be comfortable with objects now, and it’s time to use in turn acting on that data to create other conditions 
codeblocks some code concepts to control them and createabasic orneeds. 
> STB code framework that will evolve into a playable game. CPUs do that by simply performing one instruction 
magpi.cc/ Last time we bounced a couple of triangles around, at a time and then passing control to the next 
aeces9 but triangles are not much use for games. We need instruction; an instruction could be something which 
> A pretty picture; to be able to move variable-sized objects around and changes, inspects, or stores selected variables and 
nottoo hd have some control over the graphics they present us then continues to the next instruction in line, or 
with to make our games fun and interesting. passes control to a different set of instructions. 
But wait, all this tech is overwhelming. So far we In C/C++, instructions can be singular, like: 
haven’t really learned much about code, so it’s time to 
explain some of that and go through what we did last int a = 1; 


time sO we can expand on it. 
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Or grouped, using {} braces: 


{ 

Int a = 1; 
Int b = 2; 
Int c = atb; 
} 


Groupings make more sense when we want to doa 
number of different things following a test. Braces {} 
will become both your friend and your enemy ~— as will 
the ; at the end of an instruction, which is ‘nearly’ 
always needed. 

Both these singular and grouped instruction 
examples are setting up integer-type variables, and 
putting values into them. C/C++ insists you let it know 
what type of variable you are creating so it can be sure 
you put the right type into it — it’1l usually complain 
if you don’t! For now, we will use int and float; int 
types are for integer whole numbers, and float types 
are for more precise floating point numbers like pi: 


float Pi = 3.14159265f; 


Variables generally should be named something 
appropriate to their function. For example: 


int MyAge = 54; 
... makes more sense when reading it back than: 
int ma = 54; 

It’s up to you what names you use, but generally it’s 
best to make variables describe what they are holding. 
There is no limit on the size of your variable names, so: 
int I_will_be this_age next_birthday = MyAge + 1; 


...1S valid, but will get you some funny looks at a 
code review. 


Magazine 


rasphelrypLorg/magpl 


Figure 2 A familiar graphic 
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Not too much to remember 

There aren’t actually many instructions in the C/C++ 
language, but it does have a lot of very specific rules 
on how to use them. We’1l stick with the simpler 
ideas to begin with, and expand our understanding 
as we need to. 

When last time we added a Speed variable to our 
Xpos variable, we were able to test the resulting 
new position of our object and decide if we make 
a change to our Speed value, or not. A choice was 
made based on a condition test. We asked a simple 
question: if the Xpos is bigger (or less) than the 
value representing the edge of the screen, (then) do 
something to alter the direction, in this case negate 
the speed we move. 

If, then, else concepts are important to most 
languages, even if they don’t have the ‘then’ 


MagPiHelloTriangle. 


Cpp, 
SimpleObj.h/cpp, 
Game.h/cpp, 
OGL.h/cpp 


DOWNLOAD: 


magpi.cc/2suLVC2 


If, then, else concepts are 
important to most languages, 
even 1f they dont have the ‘then’ 


keyword, C/C++ does not actually have that word, but 
it’s helpful to think it when you are writing code. It 
lets us make decisions based on the resulting truth or 
otherwise of a test. 

How did that decision process make an entire 
triangle move? Well, it didn’t: it made a reference 
point at the centre of that triangle move, and we 
simply told our GPU to build a triangle around that 
X,Y co-ordinate. We were able to abstract the concept 
of the triangle, down to one single point and modify 
that with simple arithmetic, adding a + or — speed to 
move it on each update. 

So there are a few basic principles we should be 
able to get our head around from that. 


Assignment: where we store a value into 
a variable. 
Manipulation: where we modify the value 


of a variable. 

Condition checks: where we test variables and 
potentially change the sequential 
flow of our program. 


These are great foundations, but because a 
program usually goes from one instruction to the 
next, it will eventually reach the end of the code. 
That’s where some special flow control methods 
we call loops come in. We’ve seen one type of so far 
unexplained loop, the for loop, which we used to 
repeat our updates. 

A for loop, when set up, is given a counter variable, 
with an initial value, which it then automatically 
modifies at the end of each loop. It then compares 
the counter to see if the condition also stated in the 


TYPE 
CAREFULLY 


Typing slowly 
and carefully 
forces you to 


think about 
what you 
enter, and 
helps you 
to manage 
your code. 
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USE 
SENSIBLE 
VARIABLE 
NAMES 


A variable that 
explains its 
own function is 
easier to keep 
track of. 


for declaration is still true. If not, it exits the loop, 
otherwise it starts again, this time with the new 
value in the counter. 

50: 


for (int a =@; a<20; a+t) 
{ /* this is the start of the loop*/ 

//.. do any amount of stuff between the {} 
}/* the end brace is the end of the loop*/ 


... Just makes the loop start at o (int a=@), and at 
the end of each loop it will increment a (a++) until 
such time as a is no longer less than 20 (a<2@). 

How that counter is modified is up to us, but 
usually we just settle for a simple increment a++, 


Triangles might be cute, but theyre 
nota lot of use for games. We need 
something more functional 


Figure 3 
With or without 
texture 


or decrement a--, which allows us to use the counter 


as a handy index to lists of things we want to process. 


The code between brackets can be anything at all. 
Here it will repeat 20 times with this formatting and 
give us the ability, if we want it, to use the a variable 
for different things, each time being a value 1 more 
than the last time; we call this iteration. 

There are a couple of other types of loop; we’1l 
discuss them as we need them. For the meantime 
a for loop is simple to understand, and we will use 
it often. 


Being able to test things and choose the next set 
of instructions we do is an important concept. This 
is what gives us program flow control and it’s crucial 
to getting computers to do what we want them to 
do and change the sequence of instructions we want 
to follow. 

All these concepts are easier to visualise when we 
can see some actual result on screen, but triangles 
are not quite what we need -— let’s expand our 
eraphical abilities a bit more. 


Time to get square 

Triangles might be cute, but they’re not a lot of use 
for games. We need something more functional, so 
we’ll build our first games from two basic concepts: 
Sprites and tiles. 

Both are essentially square objects, which can be 
made from two right-angled triangles. Tiles can be 
used to create a background, and sprites can be used 
to represent our objects/players moving around. 
We’ll focus on tiles this time. 

Let’s make a pretty simple change to our current 
Lesson 2 system, So we just send two triangles to 
the GPU and ask it to draw them as a square. In 
your SimplObj.cpp file, change the contents of 
TriVertices to this: 


static const GLfloat TriVertices [] = 
{ 0.1,0.1,0.0, -@.1,0.1,0.0, 90.1,- 
@.1,0.0, -@.1,0.1,0.0, -0.1,-0.1,0.6, 
@.1,-0.1,0.0, }; 
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You should see there are now Six points/vertices 
representing the tips of two right-angled triangles, 
some of them duplicates — we’1l cover that later. 

And also, in the Draw method, change the 
glDrawArrays to now draw Six vertices. Compile 
and run. 

Nice, we have red squares (well, squarish), as in 
Figure 1; it’s half-way there. Next we need to make 


those squares into some kind of recognisable graphic. 


We can’t really do that in the Lesson 2 code without a 
large listing, so let’s get hold of Lesson 3 code, which 
will now load some graphics for us (Figure 2), create 
textures (Figure 3), and let us put a simple image on 
screen (Figure 4). 


Loading graphics 
Images are funny things; they come in many formats 
and resolutions, but for use as graphics in our games 
we need them in very raw byte-for-byte formats. That 
requires us to load the funny formats and convert 
them into raw data ready for OpenGL ES 2.0 to turn 
into a texture for display. That’s quite a chore that 
most sane coders avoid, so we need some help with it. 

Notice in the new OGL.cpp file that we also adda 
new header, called stb_image.h, which is a helper 
system that will let us load and convert images. We 
can largely ignore how it does what it does, just be 
confident that it does what we need it to do. It’s part 
of several helper systems collectively known as STB, 
from coder Sean T Barrett, and is public domain so 
anyone can use them. See the ‘You’1] Need’ box on 
the first page! 

Let Git do its thing and you will now have a new 
directory called, unsurprisingly, STB, and in there 
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will be the stb_image.h file we need. You can 
choose to copy it to your working directories, or just 
leave it there and make sure that Code::Blocks adds 
/home/pi/stb to its list of directories, as we have in 
the Lesson 3 project files for you. 


A new initialisation 

Looking at Lesson 3’s source, you can see OGL has 
been adapted to load a familiar image and turn 

it into a texture. The shaders are also adapted 

to use that texture. Take a look again at the 
TriVerticesWithTex list in SimpleObj.cpp and you 
will see some more small changes and explanations 
in code. 

It’s still all a bit hard-coded, making it inflexible, 
but for tutorial purposes we can now see that we 
are able to draw a new kind of textured object. Now 
SimpleObj is able to display graphics! 

So far so good, it’s still not very elegant code, 
but we have managed to put our graphics on screen 
with very little effort. We could put a lot of them on, 
creating multiple instances of a SimpleObj. But 100 
squares with the same graphics isn’t fun. Next time 
we need to add some flexibility to load and control 
more graphics and have them do different things. 


LEARN TO CODE WITH C 


Enjoying using C and C++ and cant wait until next 
month for more? Check out our Essentials book, 
Learn to Code with C, for more C tutorials for 


beginners: magpi.cc/learn-c-book 


Figure 4 
And now we can 
draw images 


TRY YOUR 
OWN IMAGES 


You can use 
almost any 
image, but 


keep it below 
1024x1024 
pixels. PNG is, 
we believe, 
probably your 
best option. 
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> 


> 


> 


> 


> 


> 


Need 


PC (desktop or 
laptop running 
Windows, Mac 
or Linux) 


Pi Zero (any 
model) with 
GPIO header 


Debian Stretch 
with Raspberry 
Pi Desktop on 
USB stick 
rpf.io/x86 


micro USB 
cable or Pi Zero 
USB Stem 
magpi.cc/ 
2Gb2d67 


LEDs and 
a button 


3D Xmas Tree 
magpi.cc/ 
2GewFwe 


SnowPi 
magpi.cc/ 
2GdupFA 


Asa 

Christmas 
decoration, we 
used the Pi Hut 


3D Xmas Tree and 


Ryanteck SnowPi 


boards together by 
plugging a Pi Zero 
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into a Pi 3 


PI ZERO 


BEN NUTTALL 


Raspberry Pi's Community Manager, 
creator or the GPIO Zero Library, 
and the Foundation’s resident 
Python expert. 
twitter.com/ben_nuttall 


This laptop is running the 
Raspberry Pi Desktop x86 OS 


The pinout command-line tool 
is a handy reference guide to 
the Raspberry Pi's GPIO pins 


The Pi Zero is connected using 
a short micro USB cable only 


Access the GPIO pins on a Pi Zero from your PC, 
or double the available GPIOs on a Pi 3! 


he latest release of the Raspberry Pi Desktop 

x86 Operating system alongside Raspbian 

Stretch for Raspberry Pi includes a new GPIO 
expander tool. Now you can easily run GPIO programs 
from your PC by simply plugging in a Pi Zero witha 
single USB cable and no SD card is required. It’s handy 
for prototyping, and can be really useful in coding 
clubs, libraries, and schools where the conventional 
Pi setup isn’t possible. It has limitations, but it’s ideal 
for lots of GPIO projects, such as many of the GPIO 
Zero ones you’ ll find in The MagPi. 

The GPIO expander tool means you can connect a Pi 
Zero (original, W, or WH) to a regular PC with just a 
micro USB cable, no SD card required, and control the 
GPIO pins. The easiest way to get it working is by live- 
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booting the Raspberry Pi Desktop x86 OS on your PC. 
Remember, when live-booting, once you shut down, 
just remove the USB stick and you can return to your 
usual operating system and get back to your boring 
spreadsheets or whatever. 

Boot into the Stretch release of Raspberry Pi 
Desktop, which comes with everything you need, 
ready to go. Plug in your Pi Zero and you’ ll be 
prompted to select a role for the device. Select ‘GPIO 
expansion board’ and continue. It will take 30 seconds 
or so to flash it, then the dialogue will disappear. 

Once the dialogue disappears, that means your 
Pi Zero is ready. Try pinging it just to be sure it’s 
connected. Open a Terminal and type: 


ping6 fe8@: :1%usbe 


This is the Pi Zero’s IPv6 address. You should see some 
responses, so press CTRL+C to stop pinging. If you can’t 
connect to it, try plugging it back in and trying again. 
You’ll need to define two environment variables to set 
this as the default route for GPIO commands. Type: 


leafpad .bashrc & 
This will open a simple notepad editor with your 


user’s Bash configuration. Scroll to the bottom and, 
on new lines, add: 
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PI ZERO GPIO EXPANDER 


export GPIOZERO PIN _FACTORY=pigpio Sa which is connected 
export PIGPIO ADDR=fe8@: :1%usbO via a USB cable. When Karty 
the button is pressed, 


Save the file and close it. Now close the Terminal the LED lights up. NAME: 


window and open up a Python editor or shell (such as Again, this is the tree_sp_2.py 
Thonny or IDLE). Connect up an LED or a simple LED , simplest of examples, Hiifa\ VM May-\ar 
board like a Pi-Stop, and write the following code to aaa but it demonstrates rpf.io/xmascode 
flash a single LED (you’1] need to know which GPIO pin a the principle of 
number it’s connected to — we’re using GPIO 17): — controlling devices 
Seca attached to two 
from gpiozero import LED different Pis. 
led = LED(17) — = A better use for this 
led. blink() Above When you pluginaPiZero, | would be to use two 
you'll be prompted to use itasa HATs or other add-on 
GPIO expansion board 
You should see the LED on the Pi Zero blink on and boards which use the 
off continuously. That’s just the start! Take a look at whole pin header; for example, the Pi Hut 3D Xmas 
the GPIO Zero documentation (magpi.cc/2qd2MEb), Tree and the Ryanteck SnowPi. The Christmas tree 
as well as plenty of tutorials in The MagPi for lots of uses all available GPIO pins for its LEDs, and SnowPi 
different projects you can do with GPIO Zero. uses nine of its own. But of course, you can simply 
place one board on the Pi3, and another on the Pi 
Using two Pi devices together Zero and when creating the relevant GPIO Zero device 


As well as using GPIOs from your PC, you can connect objects, use the remote pin factory for one: 
a Pi Zero to another Raspberry Pi and use two sets of 


GPIOs together, controlled within the same script. tree = LEDBoard(*range(2, 28)) 
This is similar to the principle of remote GPIO, which sp = SnowPi(pwm=True, pin_factory=pizero) 
was covered in issue #60, but instead of using Pi 
devices over a LAN (local area network), where each If you want to run a Python script on boot (using 
Pi has to be running Raspbian from an SD card, this @reboot in cron), there’s a trick you can use to wait 
method again just requires a Pi Zero and a USB cable. for the Pi Zero to be booted over USB before you try 
Now boot a Raspberry Pi (e.g. a Pi 3) running the to control it. The PiGPIOFactory connection will 
latest Raspbian Stretch. The Pi Zero tool is not pre- fail with an OSError if the Pi Zero is not available, 
installed in Raspbian, so you’1l need to install it. Open so you can just keep trying that until it works using 
a Terminal and type: a try/except block: 
sudo apt install usbbootgui -y pizero = None 
while not pizero: 
When it’s booted, connect a Pi Zero with a USB cable try: 
and this time, instead of setting the default pigpio pizero = PiGPIOFactory('fe8@: :1%usb@' ) 
address and pin factory, you’1l define that within the except OSError: 
code. Open a Python editor and type out: sleep(1) INSTALLATION 
GUIDE 
from gpiozero import LED, Button ...then proceed to create the SnowPi object on the 
from gpiozero.pins.pigpio import pizero pin factory. erie 
PiGPIOFactory As you can see in our final code, we turn the tree Raspberry Pi 
from signal import pause star LED on, have the tree’s red LEDs randomly Desktop on 
flicker, and have the SnowPi’s LEDs blink on and off. at oe 
pizero = PiGPIOFactory('fe8@: :1%usb@' ) issue #60. 
Or watch our 
btn = Button(17) # button on Pi 3 USB MAGIC aren 
led = LED(17, pin_factory=pizero) magpi.cc/ 
# led on pi zero The Pi Zero features a USB OTG (on-the-go) port, 2wkkThL 
allowing you to boot over USB from a PC. Your rz, 
led.source = btn.values PC sends the required boot firmware to the Pi 
over the USB cable, launching a mini version of ASP 
pause() Raspbian and booting it in RAM. The OS then starts BBLS 4 
the pigpio daemon, allowing ‘remote’ access over 
Here you have a button connected to GPIO 17 on the the USB cable. 


Pi 3, and an LED connected to GPIO 17 on the Pi Zero, 
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YOUR QUESTIONS ANSWERED 


FREQUENTLY 
ASKED QUESTIONS 


Your technical hardware and software problems solved... 


OLD 


OARDWARE 


NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Scratch 2.0 

Unfortunately, Scratch 2.0 requires you to use a newer 
Raspberry Pi as it requires a lot of resources compared 
to Scratch 1.4. You can still use Scratch 2.0 on a web 
browser on your home computer, though. 


HATs 

HATs are backwards compatible with even the Pi B+ and 
A+, but not a Raspberry Pi with 26 GPIO pins like the 
original Model B and Model A. We still see some add-ons 
that use 26 pins to attach to the Raspberry Pi, though. 


Use it elsewhere 

The original Raspberry Pi, while nowhere near as 
powerful as a Pi 3, is still no slouch at many computing 
tasks. If you’re not using it for experimenting with 
projects, you can always turn it into a file server, or 
just use it for testing out simple circuits using Python. 


Give it to aq young maker 

Know a child interested in computing but hasn’t been 
introduced to Raspberry Pi yet? Gifting one might be 
the beginning of a long career in software engineering 
or otherwise. It would also give them a leg up on 
computer science lessons at school. 


Recycle 

Literally can’t find a use for your Raspberry Pi? No 

one you can gift it to? No room to keep it? Do the 
responsible thing and sell it, or recycle it with an 
electronics recycler so the parts can go towards making 
other electronics without contributing to landfill. 


In general 

Python is standard, and the GPIO pins (however 
many you have) all work the same way, so 
coding with the original Raspberry Pi is the 
same as programming with a Pi 3 or Pi Zero W. 
Even Minecraft Pi and Scratch 1.4 work on older 
Raspberry Pi models just fine. 
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Can | buy older models? 

Yes! You can get brand new Model A+, Model B+, and 
Raspberry Pi 2 boards. We’ve also seen stock of Pi Zero 
v1.3 boards on Adafruit. They all tend to be priced low, 
although it does depend on where you shop. 


Why would | want an older model? 

Your needs may require a smaller Raspberry Pi (like 

the Model A+) or for your project to draw a little less 
power than a Raspberry Pi 3. You may even like the 
bulk-buy discount on the cheaper Pi boards. While we 
recommend getting a Raspberry Pi 3, that doesn’t cover 
all cases. 


Buying used Raspberry Pis 

Like buying anything used, you need to understand the 
risks. Luckily, eBay has good buyer protection these 
days so if a Raspberry Pi you buy doesn’t meet the 
description on the listing, then you should be able to 
geet some money back. Raspberry Pi boards are fairly 
hardy, though, so you’re unlikely to come across many 
faulty units. 
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FROM THE RASPBERRY PI FAQ 
RASPBERRYPI.ORG/HELP 


WHAT HARDWARE INTERFACES DOES IT HAVE? 

Depending on the model, the Raspberry Pi has either 40 or 26 
dedicated GPIO pins. In all cases, these include a UART, an I?C bus, 
an SPI bus with two chip selects, I?S audio, 3V3, 5V, and ground. 

The maximum number of GPIOs can theoretically be indefinitely 
expanded by making use of the I?C or SPI bus. There is also a 
dedicated CSI-2 port for the Raspberry Pi Camera Module, and a DSI 
display port for the Raspberry Pi LCD touchscreen display. 


WHY IS THERE NO REAL-TIME CLOCK (RTC)? 

The expectation is that non-network-connected units will have their 
clocks updated manually at startup. Adding an RTC is expensive 
once you factor in batteries, area, and components, and would have 
pushed us above our target price. You can add one yourself using 
the GPIO pins if you'd like an interesting electronics project. 


CAN | ADD EXTRA MEMORY? 
No. The RAM on the ModelA, A+, B, B+, and Zero is a package 
on package (POP) on top of the system on chip (SoC), so it is not 


removable or swappable. The RAM on the Pi 2 and 3 Model B 
versions is on a separate chip on the bottom of the PCB, but 1GB 
is the maximum RAM that the SoC used by the Pi 2 and 3 Model B 
versions can support. 


WHY DOESN'T THE RASPBERRY PI INCLUDE A CERTAIN PIECE OF 
HARDWARE OR A CERTAIN SORT OF PORT? 

Our main aim is a charitable one: we are trying to build the 
cheapest possible computer that provides a certain basic level of 
functionality, and keeping the price low means we've had to make 
hard decisions about what hardware and interfaces to include. 


WHAT IS ITS OPERATING TEMPERATURE? 

The Raspberry Pi is built from commercial chips which are qualified 
to different temperature ranges; the LANg514 (LANg512 on older 
models with two USB ports) is specified by the manufacturers as 
being qualified from 0°C to 70°C, while the SoC is from -40°C to 85°C. 
You may find that the board will work outside those temperatures, 
but we're not qualifying the board itself to these extremes. 


INTRODUCING THE HOTTEST 


PRODUCTS FOR YOUR PI 


feature 


Privacy and 
security on, 
and with, your 
Raspberry Pi 
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igital security is very important. With recent 
D revelations over how people can exploit the 
vast majority of modern processors to access 
your private data, it’s never been more important 
to learn how to improve your online security. While 
the Raspberry Pi may be immune to Spectre and 
Meltdown, it doesn’t mean you shouldn’t improve 
your own security. 
So in this article, we’ll help you to protect 
yourselves from nasty folks online, and even show 
how your Raspberry Pi can help you in this effort. 
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THE PASSWORD [igjauam 
BASICS OF | 22-2" 
S E C U R | Py Vv LEARN HOW TO CREATE TURN ON TWO-FACTOR 

A STRONG PASSWORD AUTHENTICATION 

We could write pages on It may be a pain, but it means that 


this, so instead we'll point even if someone works out your 


Before we secure your PI, make sure you towards this great guide: password, your more important 
to follow these basic security tenets magpi.cc/2rXxYHcb, accounts will be safe. 


DON'T REUSE PASSWORDS GET A PASSWORD MANAGER 


he most secure computer and network in the 
world won’t be much use if your passwords 
can be cracked because you used password1 
everywhere. Here’s a refresher on how to keep your 
online presence safe. 


ONLINE 


If one password is compromised, Services like 1Password 

then all your accounts with that (a4password.com) and KeePass 

password are. (keepass.info) allow you to use 
unique, machine-generated 

DON'T USE DICTIONARY WORDS passwords on accounts that 

It might be common sense, but you can then unlock witha 

common cracking techniques master password. 

start with dictionary words. 


BE PREPARED TO CHANGE IT 
DON'T USE A COMMON While the current school 
PASSWORD of thought is not to update 
Check this list to make sure passwords every 90 days any 
you're not doing anything silly: more, you may still need to 
magpi.cc/ 2rxjFlz2. change a password if there's 
a security leak or similar. 


TWEAK YOUR PRIVACY SETTINGS 
Facebook, Twitter, and other social media services 
let you change the privacy of certain account 


aspects. Make as Little public as possible. 


eerste repro 


OTHER TIPS 


CREATE A REDUNDANT EMAIL ACCOUNT 

For accounts that aren't important or don't contain 
important information, use a second email account to sign 
up to them. That way, if someone cracks your secondary 
email, they won't have the keys to the kingdom. 


LIMIT APP ACCESS TO YOUR ACCOUNTS 
Some places let you log in via Facebook or Twitter, or 
will connect to your social media accounts. Regularly 


check what does and does not have access to your 
account, as old apps may end up compromised. 


BE CAREFUL WHAT YOU SHARE 
It may be common sense, but always think about 
what information you're giving out. 


KEEP YOUR SOFTWARE UPDATED 
Acommon part of software updates include security fixes, 
so always update your software when you can. 


USE A PSEUDONYM 
While perhaps an extreme step and not applicable 
on every social media network, it will aid your 


privacy and security. 
BE AWARE OF PHISHING SCAMS 


Always remember that hackers will send emails that look 
like they're from your bank or Facebook or similar asking 
you to log in. Check the sender and if in doubt, go to the 
original website. 


ADD RECOVERY CONTACT INFO 

Google recommends you add a phone number or alternate 
email to an important account so they can contact you if 
they think anything is wrong and confirm it is the real you. 


i, 


ee ee es po S| 
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he Raspberry Pi is inherently fairly secure, 

especially if you’re using the default 

operating system, Raspbian with Raspberry 
Pi Desktop. Raspbian is a form of Linux, which is 
much more resistant to hacking than Windows or 
macOS, and you’re also unlikely to come across any 
viruses for it. 

While secure, it doesn’t meant Raspberry Pi and 
Raspbian are invincible. Here are some tweaks you 
can do to make sure your Raspberry Pi and everything 
on it are more secure. 


As the pi username is the default, you may wish to 

create a new uSer account and remove the ‘pi’ user 
from being able to make changes to Raspbian. Find 
out how to do this here: 
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PASSWORD 
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SoH 


SSH (Secure Shell) is a way for computers to talk to 
each other over a network. It’s like being able to open 
a Terminal window on another computer — although 
you have to know where the computer you want to talk 
to is, and the username and password. 

On Raspbian this is made easy - by default all 
Raspbian- powered Pis use ‘raspberrypi’ as their name 
on a network. To SSH in, all you need to do is navigate 
to pi@raspberrypi and enter the password raspberry. 
SSH is turned off by default; however, if you do decide 
to turn it on, look at the above tip on how to change 
the password. 


From the Raspberry Menu, go to Preferences and find 
the Raspberry Pi Configuration option. From there, go 
to the Interfaces tab and click Enable next to SSH. 


ENCRYPTION 


Encrypt your Raspberry Pi’s storage 
so that only you can access it 


Once you've set up Raspbian on your Raspberry Pi, you 
can encrypt the root partition (where the operating 
system is kept) to make sure that you need a password to 
access any of the files within. 

You might be wondering why you would need to do this 
over just turning off automatic login — the reason is that 
the microSD card can be removed from the Raspberry Pi 
and the files read on another computer. If you encrypt the 


data, this can't happen. 
RALI LINUA 


If you need an all-in-one encrypted operating system 
with maximum security, try out Kali Linux. It's already 
extremely secure, and with a few modifications it can 
be fully encrypted as well! 

Kali Linux is not your average Pi operating system, 
though - it's for computing professionals who need to 
test their networks for vulnerabilities. You won't be able to 
make the same kind of projects as you would in Raspbian. 
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You can find out more on how SSH works in 
Raspbian in the documentation, including how 
to turn it on when you don’t have a monitor, 
here: 


> ia 
7 x 
¢ XN 
4 A 
| Check out \ 
l the full Raspberry Pi i 


1 list of ways to improve | 
1 Raspbian’s security: 4 
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SECURE YOUR 
COMPUTERS 
WIIH PI-HOLE 
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INSTALL 
PI-HOLE 


You’ll need: 
Raspberry Pi (any model) 
Raspbian, connected to a network 


Pi-hole turns your Raspberry Pi into an 
ad-blocker, making sure no malicious 
code from dodgy adverts gets to your PC 


nline ads can be dangerous for your 
computer and your network. Malicious 
code can easily infiltrate ad networks 
and become a Serious issue before the ads are 
eventually removed. While this kind of code is 
unlikely to affect your Raspberry Pi, it can infect 
other computers on your network. With some 
special software, you can create a network-wide 
ad block using just your Raspberry Pi, thanks 

to Pi-hole. 


>STEP-O1 

Get the software 

Pi-hole comes in a complete and easy-to-use installer 
that can be quickly used on your Raspberry Pi. Open a 
Terminal and use the command: 


curl -sSL https://install.pi-hole.net | bash 


y a= = ~ This will download and then automatically install 
the Pi-hole software. You can do this in the command 
t WANT TO d line (we recommend you turn off the desktop for your 


Pi-hole device anyway) as well as SSH. 


>STEP-02 

Configure your network 

For the desired ad-blocking effect, you need to make 
it so all the computers on your network access the 
internet via your Pi-hole Raspberry Pi. To do this, 
you need to change the DNS settings on your router. 
This requires you to know your Pi’s IP address on the 
network, so run the command ifconfig to find it. 


WHITELIST WEBSITES 
YOU KNOW TO BE SAFE? 
Check out the : 
details on how here: | 
magpi.cc/2BZ8n64 yA 
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Your router will have instructions on how to access 
the admin settings, usually printed on a label on 

the back of the box. Log in to your router and find 
the settings for its DHCP server. This is used to 
automatically send details to your devices on how to 
connect to the internet. Change the value of the static 
IP address to that of your Raspberry Pi on the network. 
It might require a restart afterwards, but otherwise 
you’re done! 


Configure your network 
If you can’t change the DHCP settings on your router, 
you can turn on Pi-hole’s own DHCP server which will 
then automatically manage devices on your network. 
You can find this option, along with many other 
settings, by going to p1.hole in a web browser. 

There are other more advanced/manual methods 
for sorting out the DNS settings as well, and they 
can all be found in the Pi-hole documentation here: 
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SECURE YOUR 
NETWORK 
WITH TOR 


Create an qutomatic Tor router that 
aqnonymises your online location, 
allowing you to maintain complete privacy 
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rivacy on the internet is tricky. Everywhere 
you go you accumulate cookies and servers 
will log your IP. For vulnerable people, this 
can be dangerous. Tor allows you to almost completely 
mask your presence online, 
and here’s how you can use 
a Raspberry Pi to make your 
entire network private. 


You’ll need: 
Raspberry Pi 3 
Ethernet cable 


First of all you need to turn your Raspberry Pi into 
an Access Point, which lets other computers wirelessly 
connect to it and use it as a bridge to your router. 
Connect your Pi to your router via the Ethernet cable, 
and leave the wireless LAN connection alone. To 
make the wireless LAN on the Pi 3 act like an AP, just 
execute the following commands in the Terminal: 


git clone https://github. com/unixabg/ 
RPI-Wireless-Hotspot.git 

cd RPI-Wireless-Hotspot 

sudo ./install 


You’ll need to agree to some terms and DNS 
options, but say no for the wireless LAN defaults. It 
will then prompt you to enter details for the wireless 
network you want to create and connect to. For the 
final two options, choose no and your Raspberry Pi 
will reboot. 

Now we can install Tor on your Pi. First, update 
Raspbian with sudo apt-get update and then sudo 
apt-get upgrade to make sure everything is properly 
installed from the previous step, and then install 
Tor with: 


sudo apt-get install tor 
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need to configure it. 


of co 
Log not 
VirtualAda 
AutomapHostsS 
AutomapHostsOnRe 
TransPort 9040 
TransListenAddress 1° 


DNSPort 53 
DNSListenAddress 192.168.4 


Next, you need to dump all the old rule 
the IP table: 


sudo iptables -F 
sudo iptables -t nat -F 


Now set the DNS to route through Tor: 


sudo iptables -t nat -A PREROUTING -i wland@ 
-p udp --dport 53 -j REDIRECT --to-ports 53 


Route all TCP traffic through Tor: 


sudo iptables -t nat -A PREROUTING -i wland@ 
-p tcp --syn -j REDIRECT --to-ports 9040 


Make sure to check all these new routes with: 
sudo iptables -t nat -L 
Finally, save our new rules to the NAT table: 


sudo sh -c "iptables-save > /etc/iptables. 
ipv4.nat" 


Once that’s down, you should create a log file to 
track your Pi’s Tor usage. Create an empty file and 
then change its permissions with: 


sudo touch /var/log/tor/notices.log 
sudo chown debian-tor /var/log/tor/notices.log 
sudo chmod 644 /var/log/tor/notices. log 


Once that’s all done, you can start the Tor service 
with sudo service tor start. You can also then 
check it with sudo service tor status to make 
sure it’s all running properly. 

Finally, change the service to start on boot with: 


sudo update-rc.d tor enable 
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HOW 
WORKS 


Relay networking and how 
it keeps you safe online 


or’s main function is to protect your 
T anonymity online. The way it does this is by 
routing web traffic through several encrypted 
servers around the world — in a sense, it bounces the 
contents of a webpage around different computers 
across the globe to then be read by your computer. 
A bit like in a film. 

This allows users to conceal their location, and 
will stop anyone monitoring your network from 
figuring out what you’re using the internet for. This 
can be anything as simple as concealing what you’re 
getting a network engineer for their birthday, or for 
more serious uses such as staying hidden from an 
abusive partner. 

Tor is not invincible though, and should be used 
with caution. Not every website allows access via Tor 
either. If you don’t want to have your entire network 
running under Tor, you can always use the Tor 
Browser: 


Congratulations! 
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The Tor Browser is an alternate way of staying hidden 
on the internet instead of encrypting your entire network 
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Want to learn more about Raspberry Pi and 
computing security? Check out these links. 


A general advice website that gives privacy tips 
on just about every part of your online experience 
— it even has sections on how parents can help 
safeguard their kids. Privacy and security online is 
always evolving, so it’s worth checking regularly 
to see how you can improve your online safety. 


Official advice from Raspberry Pi on ways you 
can improve the security on Raspbian and your 
Raspberry Pi. It covers some of the stuff we 
mentioned on previous pages but goes into a lot 
more detail, as well as offering more advanced 
methods of controlling your security on the Pi. 


Change your default password 
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HOLOGRAM NOVA 


Waker 
says 


Nova Is 


the simplest 
olug-and- 
play modem 


E) OAM 
heen 1D 


for instant = ok alam: jj aa 


connectivity 
Hologram 


Connecting a Raspberry Pi to a mobile 
network anywhere in the world is something 
Rob Zwetsloot is very interested in 


n past issues we’ve talked — one of the first made specifically strength of the signal where you’re 

about ‘mobile’ Raspberry with Raspberry Pis in mind, and it planning to use it. 
Pi devices a few times in works really well. a 
various contexts. However, one The Nova itself is a very simple Software & subscriptions 
of the concerns with creating a device. It’s a USB dongle that you The Nova isn’t just plug-and- 
truly mobile Raspberry Pi project can slot a SIM card into (supplied play, though — you won’t be able 
Related is giving your Pi an internet with the Nova) and then plug to just use it like a WiFi dongle on 

connection wherever you go. into your Raspberry Pi. You can a Raspberry Pi. Luckily, you only 
LEARN MORE You could always hack about with disassemble it to access the SIM need to install one bit of software 
ABOUTNOVA a mobile hotspot on your phone, card slot and swap between two which is available online (Hologram 
You can find but cellular modems have always included antennas depending on recommends you have a pre- 
a tutorial on a ; 
how to set up been an alternative. The Nova is how much space you have and the existing network connection to set 
and use your up your Nova before using it) to get 
Hologram Nova = fone | Lone 2 includes Zone | coverage q aii yourself connected, with another 
in issue 64 of ; 

piece of software required to use the 


The MagPi. 
: SMS features. 


While getting your Raspberry 
Pi to connect to a mobile network 
through the Nova is easy and quick, 
it doesn’t mean you’!] then have 
instant internet access. For that, 
you need to set up a subscription to 
Hologram’s data plan. 

It’s easy enough to activate your 


, magpi.cc/2AqrV6q ) SIM card on there. You just create 
an account, put in your SIM card’s 
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serial number, and select from a 
few data plan options. By default, 
you can select from a couple of 
pay-as-you-go options that charge 
you by the megabyte (and SMS), 
with differences in price depending 
on what countries you’d like the 
Nova to work in. 


size and quality of photos taken by 
the Raspberry Pi Camera Module 
to keep the file size (and therefore 
upload price) fairly fixed and 
within a project’s budget. 

You can upgrade the plan from 
‘most of the world’ (Zone 1) to 
‘almost all of the world’ (Zone 2), 


The Nova Is one of the first made 
specifically with Raspberry Pis 
in mind, and 1t works really well 


There’s also a monthly contract 
plan, but it’s currently only 
available to people in the US. 


Pricing and regions 

The cost of Nova is fairly cheap 

at So.60 (£0.43) per minute for 
most of the world, along with 
$0.19 (£0.14) for each SMS. While 
it would be pretty expensive to 
use it to stream YouTube videos 
on the go, that’s not really what 
it’s meant for — it’s more for 
quick data uploads and location 
pings for more advanced projects. 
Even for photos it’s not too bad, 
especially as you can tweak the 
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which notably includes Canada 
among other countries. The price 
bump is about 33%, going from 
$0.60 to SO.80 (£0.58) per megabyte 
and up to $0.30 (£0.22) for a text. 
It’s not huge but depending on the 
amount of data you’re planning to 
use, it can bea significant jump. It 
also mostly affects less developed 
countries, although it’s unlikely this 
would be their first port of call for 
internet access. 

With the contract, you can save 
a lot of money on Zone 1 data 
(100MB for $15/£11) and some 
money on Zone 2 (100MB for 
S60/643), although the price of 


HOLOGRAM NOVA 


SMS texts remain the same. Again, 
you need to be in the US to get the 
contract, but it’s well worth it for 
the Zone 1 savings. 


Usage and connection 
While we weren’t able to test it 
in every country, in the UK and 
the US we’ve found that the 
Nova works great. Focusing on 
sending small packets or limited 
file sizes of data is the way to go, 
although you’re sometimes at the 
mercy of the mobile signal so we 
recommend making sure you check 
signal strength before deploying. 
It’s frankly a wonderful little 
product, and although it may 
be aimed more at a developer/ 
business market, it ticks the right 
boxes for those specific uses. 


fast word 


The Nova is a great addition 
to the line-up of Raspberry 
Pi accessories that can really 


help improve some of your 
mobile projects. 
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SCORE‘ZERO 


A tiny controller that also helps you practise your soldering 


ver since the Pi Zero came 
out, its use for video game 
console projects has been 
widely explored. From installing 
them into classic controllers to 
hacking Happy Meal toys into 
working Game Boys, it’s been 
ereat to see just how inventive 


area when opening the box and 
getting everything ready, lest you 
lose a button. 


Small hands 

Once you’ve soldered it up, you 
need to install some software to 
get the Score:Zero working on your 


JOY people have become with them. Raspberry Pi. The Wonky Resistor 
BONNET Sometimes though, you need website has a great little guide 
me something a little more practical, to help you do the soldering and 
product, the Joy like the Score:Zero. installing — in fact, just one line 
Bonnet features It’s a plain, white PCB the size of code will get you some example 
pie eobe ofa Pi Zero that comes with a code to use with it. | 

It comes fully 40-pin GPIO header and buttons. The code is all done with GPIO 
assembled so You solder these on and then Zero so you can easily put it into 
rene place it on a Raspberry Pi’s GPIO your own game projects without 


£16 / $15 
magpi.cc/2qaSfiT 


pins — anice and simple concept. 
As there’s not much to solder, it is 
fairly quick to do and is a good way 


» to practise soldering a 40-pin GPIO 


header — in this case a female one. 
We did find some of the buttons a 
little small and fiddly, though, so 

make sure you’re at a clear work 
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having to download any of the 
code. However, you can use 
the examples along with some 
other software to quickly use the 
Score:Zero as a keyboard or mouse. 
With it sitting on top of a Pi 
Zero, we found the Score:Zero a bit 
awkward to use. The diminutive 


size of both hampered proper 
usage and the microswitches 

for the D-pad weren’t very 
comfortable to use. On a full-size 
Raspberry Pi, though, the story was 
very different — we thought we’d 
have trouble reaching the buttons 
at all, but it was generally a lot 
more comfortable to use. For those 
with smaller hands who might get 
the most out of learning to solder 
and code with it, the Pi Zero size 
probably won’t be too much of an 
issue, though. 


fast word 


Anice quick project that, while 
a bit small for adults, will be 
perfect for younger makers 


getting their start in soldering 
and programming. 
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Raspberry Pi finds a new home 


Versatile enclosure for Raspberry Pi B+ 


The new UCS-RPI Universal Case System for Raspberry Pi B+ has pre-milled side 
walls for easy access to the I/O and power inputs. It is available in black or grey, in 
two size configurations and with glue dot location posts to secure the single board 


computer to the case. 


For additional information call 0845 881 2222 or visit 


phoenixcontact.co.uk/RPIBC 
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INSPIRING INNOVATIONS 


FULL PHAT 


Maker 
Says 
Connect 
two pHATS 
to your Pi 
and still 
use spare 


GPIO ports 
RasPi0 


PHAT 
STACK 


Need to 
connect more 
add-on boards 
to your Pi? The 
PHAT Stack 
lets you use up 
to five pHATSs, 
three HATs, or 
a combination. 


£14 / $16 
magpi.cc/2mcr2Gt 


FULL PHAT 


Have double the fun by plugging in two pHATs at once. By Phil King 


ou may recall that we 
reviewed Pimoroni’s pHAT 
Stack last issue. The latter 
is amonster of a breakout board 
that enables the connection of 

up to five pHAT boards - or three 
HATs — to one Raspberry P1. 

While it works very well, we did 
mention that it might seem like 
overkill to some people. In which 
case the Full pHAT might well 
prove a more practical alternative 
with its smaller form factor. Fitting 
neatly on top of the Raspberry Pi, it 
allows you to connect two pHATSs, 
or a pHAT anda HAT. 

Well, it does once assembled. 
You first need to solder on a female 
Stackable 40-pin header, anda 
male header. Two nylon standoffs 
are also supplied to provide a 
secure fit on top of the Raspberry 
Pi. For a low-profile project, you 
could even solder the Full pHAT 
directly to a Pi Zero and eliminate 
the main header altogether. 
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The GPIO ports (all bar GPIO 26) 
are broken out twice more in two 
single rows of holes, labelled with 
special functions (e.g. SDA, SCL, Tx, 
Rx) where applicable. In addition, 
there are three holes for 5V, 3V3, 
and GND. So there’s plenty of scope 
for soldering wires directly, or via 
added pins, to connect various 
electronic components and sensors. 

The two main GPIO headers are 
also clearly labelled with their 
GPIO numbers, which is a nice 
touch and reminiscent of RasPiO’s 
Portsplus key-ring. 


Spa re ports 
Once assembled and mounted on 
the Raspberry Pi, we found it easy 
to swap pHATs and HATSs in and 
out — such as a Micro Dot pHAT and 
Unicorn HAT HD to simultaneously 
show scrolling text messages and 
a graphical display. 

As with the pHAT Stack, 
however, one caveat is that 


you need to avoid combining 

two add-on boards that use the 
same GPIO pins (unless they're 
?C with different addresses). 
Again, Pimoroni’s ‘pHAT 

Stack configurator’ online tool 
(magpi.cc/2BH6TSc) comes 

in handy here - assuming 

you’ re using Pimoroni boards. 
Alternatively, you can just check 
which pins they use at pinout.xyz. 


fast word 


Fitting snugly on top of the 
Raspberry Pi, the Full pHAT 

is useful for combining two 
pHATs (or a pHAT and HAT) and 
also as a breakout board for 


projects. To this end, the clear 
labelling of all the GPIO ports is 
a great help, as is the provision 
of two extra rows of holes. 
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DIGIONE PLAYER 


Waker 
days 


Designed 
with one 
goal in mind: 
absolute 
best S/PDIF 


output 
Allo 


JUSTBOOM 
DIGI HAT 


It lacks the 
advanced 
features of the 
DigiOne, but the 
JustBoom Digi 
HAT provides 
an S/PDIF on 
optical and 
coaxial outputs 
for a fraction 

of the price. 


£30 /$35 
magpi.cc/2IMEYFx 
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Clever engineering and top-end components 


or many, the audio on 

the Raspberry Pi’s HDMI 
port — or even the stereo 
analogue audio, accessible on the 
multifunction 3.5mm jack — is good 
enough. For others, ‘good enough’ 
is never good enough - and it’s for 
these people that the Allo DigiOne 
Player has been designed. 

Based around the DigiOne 
S/PDIF HAT (available separately, 
£86/S99), the DigiOne Player is 
designed to provide a peak-quality 
digital audio signal. While many 
will argue that digital audio is 
digital audio, being made up of 
zeros and ones which either arrive 
at the other end perfectly or don’t 
arrive at all, audiophiles claim 
otherwise — and in particular, point 
to ‘jitter,’ the deviation of a period 
signal from its ideal timings, as a 
source of audible distortion. 

The DigiOne, Allo claims, 
solves that problem. Using two 
on-board clocks as stable timing 
sources, as well as galvanic signal 
and power isolation and a variety 
of other engineering tricks, 


Allo claims to have reduced the 
jitter of the digital audio signal 
to 0.6 picoseconds — as close to 
perfect as practically possible. 
That signal is available on 
either of the DigiOne’s two outputs: 
an RCA jack and a BNC connector. 
In practice, there’s no difference 
between the two, bar the BNC 
connector being more resistant to 
accidental disconnection. What you 
won’t find is an optical output, a 
deliberate design choice by Allo to 
avoid what it claims is unacceptable 
4, nanosecond (4000 picosecond) 
built-in jitter. 


Complete bundle 
Purchased as the Player bundle, 
the DigiOne HAT comes witha 
Raspberry Pi 3; 8GB SD card with 
a choice of DietPi, Volumio, or 
Max2Play audiophile-centric 
distributions pre-installed; a5V 
3A power supply; and an attractive 
acrylic case. 

Using the DigiOne Player is as 
simple as connecting a power 
supply and linking the HAT to your 


digital-to-analogue converter 
(DAC), with the tested Volumio 
software providing a browser- 
based interface for control as 
well as acting as a streaming 
transport device for third-party 
software. When running, the audio 
quality from the DigiOne Player is 
undeniably high — but it is more 
obvious to scientific instruments 
than the fallible human ear. 


fast word 


The DigiOne Player is a clever 
piece of engineering, but the 


problem it solves is arguably 
not worth the purchase price. 
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Build a Makerspace 
for Young People 


Join our free online training course on 
makerspace design to get expert advice — 
for setting up a makerspace in your 

school or community. | 


@8) Raspberry Py The Raspberry Pi Foundation. UK registered charity 1129409 #RPiLearn 
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PIGLOW 


Aspiral nebula 
of 18 individually 
controllable 
LEDs supported 
with a Python 
library. Can be 
used for status 
output or purely 
for decorative 
patterns. 


) £9/812 
magpi.cc/2nxGOvl 
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Waker 
says 


Strengthen 
your logic by 
typing complex 
code to draw 


patterns 
SB Components 


PICUBE 


Add a tower of 64 LEDs to the top of your Pi 


and create hypnotic sequences. By Sean McManus 


iCube is a 4x4x4 grid of 

LEDs to sit on top of your 

Raspberry Pi 2, 3, or Zero. 
That means there’s a total of 64 
lights, many more than you could 
connect directly to the GPIO pins. 

The secret is multiplexing: the 
pins are arranged in columns and 
layers. All the LEDs in the same 
column share a common anode, 
and all the LEDs in the same layer 
share acommon cathode. That 
means each horizontal layer has 
the same lights switched on as the 
others, or is completely dark. As 
a result, PiCube isn’t suitable for 
games or projects that would need 
the lights to be independently 
controllable. It’s fun to experiment 
with, though, and could provide 
a highly visual way of teaching 
nested loops and nested lists, 
or experimenting with logic. 

You don’t need to install any 
software because you can control 
the PiCube using the RP1.GPIO 
Python package to turn pins on 


or off. The documentation shows 
which pins control which layers 
or columns, and the LEDs are 
numbered on the board to help 
you find your way around. 


Cubist light 


There are three mesmerising 
demos to download, showing 
different animations you can 
create. IDLE complained about 
inconsistent indentation in the 
first one, and wouldn’t run it. 

The demos are unexpectedly in 
Python 2 (rather than 3) because 
of some old-style print statements, 
too. This all took seconds to fix, 
but it was disappointing that it 
didn’t work immediately. A simple 
‘Hello world!’ demo explaining 
how the layers work would have 
been helpful too. 

PiCube comes flat-packed, ready 
for you to build. There are 64 LEDs 
to solder, as well as soldering the 
layers to the pillars, the pillars 
to the shield, and the shield to 


the header. We make that 144 
joints, pins, or lights. That makes 
this a good project for those who 
are looking for a substantial 
soldering project with a bit more 
programmability than the usual 
LED displays. 

We experienced a dead LED on 
two of the three units we tested. 
Our units arrived pre-soldered 
(thank you!), so we don’t know 
how many knocks they took in 
transit, and this might not be 
typical. You can test LEDs before 
soldering them to avoid problems, 
as the manual recommends. 


fast word 


Anice tech demo that is fun to 
experiment with and a highly 
visual teaching aid. It has 


limited applications beyond 
education, though. 
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WITTY Pi MINI 


Want to save power, or run a program intermittently? Witty Pi Mini 
turns your Pi on and off automatically. By Sean McManus 


WITTY PI 2 
Its ‘big sister’ 
Witty Pi 2 keeps 
time for up to 

a year without 
external power. 
It can output 3A 
current to power 
peripherals too. 


£17 / $24 
magpi.cc/2nxB7gU 


itty Pi Mini adds a 
real-time clock to your 
Raspberry Pi so you can 
switch it on or off automatically, 
at set times. 

To set it up, you can create a 
simple configuration file using a 
text editor. You specify the start 
and end time for the sequence, and 
then say how long the Pi should be 
switched on for, and then switched 
off for. The on/off cycle loops 
until the end time is reached. If 
you prefer, there’s a nice online 
generator you can use to create the 
code, which includes a simulator 
showing you when your Pi would 
switch on and off using it. 

To install your configuration file, 
you use a Bash script which can 
also show you the next scheduled 
shutdown and startup times, or 
reset the Witty Pi Mini. A selection 
of example scripts is provided, 
such as ‘turn on for five minutes 
every 20 minutes’. 
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You can also use wildcards to set 
the shutdown or startup times, 
so that your Pi turns on at quarter 
past every hour, for example. 


Power up 
There’s a graphical interface 
version of the Bash script, which 
might provide some comfort to 
those who prefer not to use the 
command line. It was extremely 
slow on our Pi Zero WH, though, 
with a significant delay after 
clicking a button. It takes several 
seconds to commit a time change, 
so setting the clock with second- 
accuracy was hard. It also appeared 
to lag a few seconds behind the 
time shown in the command line. 
There are a few usability niggles 
too, so we found we preferred the 
Bash script with its simple menu. 
The real-time clock is powered 
using a capacitor, so the clock 
runs for about 17 hours without 
an external power supply. 


The Witty Pi Mini uses four GPIO 
pins, two of which are customisable 
(with some soldering). You might 
be able to combine it with other 
HATs, and should be able to use it 
with your own electronics projects. 
A stacking header is available 
separately to enable you to access 
all of the GPIO pins. 

When the Pi shuts down on 
schedule, it’s merciless: whatever 
you’ re doing, it’s going down. 
Make sure you remember if you set 
a Shutdown schedule so you don’t 
eet any unpleasant surprises. 


fast word 


Witty Pi Mini is a great tool 
if you need your Pi to do 
something on a schedule. The 


Bash script, online generator, 
and manual will get you and 
your Pi running like clockwork. 
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RASPBERRY PI 
BESTSELLERS 


Introductions to extending interesting 
languages make for some of our favourites 
in Pragmatic’s excellent Express series. 


MASTERING RUBY 
CLOSURES 


Author: Benjamin Tan Wei Hao 
Publisher: OReilly 

Price: £21.50 

ISBN: 978-1680502619 
magpi.cc/2GEg91¢z 


SS 


An easy introduction to 

Ruby’s secret weapon. The 
difficulty ramps up steadily, but 
examples and tests keep you 
on track, giving you closure 
understanding that you can 
take on to Haskell, JavaScript, 
or Elixir. 


MASTERING CLOJURE 
MACROS 


Author: Colin Jones 
Publisher: OReilly 
Price: £13.50 

ISBN: 978-1941222225 
magpi.cc/2GCWzda 


Clojure’s powerful macro 
system makes “hard things 
possible and normal things 
easy”. Jones's easy style 

makes for a painless intro, with 
intriguing suggestions for when 
to use them, but also how to 
use new your powers wisely. 


METAPROGRAMMING ELIXIR 


Author: Chris McCord _ | ; 
prs F 


ISBN: 978-1680500417 
magpi.cc/2GCX6Mc 


Publisher: OReilly 


Price: £13.50 


Not for the Elixir beginner, 

but a terrific introduction to 

accessing Elixir's Abstract | f 
Syntax Tree, and understanding 
metaprogramming through Le 

Elixir's surprisingly Lisp-like ee -— 
features. Useful examples an 

include an internationalisation 
library, and an HTML chapter. 
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MASTERING 


MEDIA write 
RASPBERRY PI 


Author: Ralph Roberts 
Publisher: Apress 
Price: £23.99 

ISBN: 978-1484227275 
magpi.cc/2GAKncO 


Despite all of its 
wonderful educational 
uses, it’s aS a media centre that 
many Raspberry Pis are destined 
to spend their days. And why not? 
It’s more satisfying — and cheaper 
— than buying one off the shelf. 
Roberts provides a comprehensive 
cuide to setting one up — yes, all of 
the information can be gathered 
from the web, but delegating that 
effort to Ralph Roberts will make 
your life easier. 

There are several things to 
consider to get the correct setup, 


ATTACKING 
NETWORK 
PROTOCOLS 


Attacking 


Author: James Forshaw 
Publisher: No Starch 
Price: £39.99 

ISBN: 978-1593277505 
magpi.cc/2GyErRL 


as Tag Conte ty af 
dost and balan 


Forshaw is quite 
well known for 
finding a number 
of Microsoft security flaws, earning 
the first S100 ooo bounty from 
Microsoft for using architectural- 
level flaws to bypass platform 
defences. Here he turns his 
attention to the kinds of network 
weaknesses which a proliferation 
of IoT devices will bring to 

homes everywhere. 

Networking basics and capturing 
traffic with Wireshark open the 
book. The reader’s hand is not held, 
as we gallop through the basics, 
and on to the binary protocol 


Network Protocols 


even at the hardware level. From 
careful consideration of getting the 
correct power supply — something 
which has occasionally tripped up 
new (and not so new) Pi users — 
and powering peripherals, to 
CEC over HDMI. The book is 
standardised on one digital-to- 
analogue converter (DAC), and 
doesn’t examine closely any of 
the other DACs available. There 
are other quirks, too, but the 
choices made are all practical. 
This is mostly a guide to Kodi, 
on LibreELEC — a sensible choice, 
and one with plenty of expansion 
options. These add-ons are also 
covered, and the guide is pitched 
such that you could give it to 
a fairly non-technical relative 
and be reasonably hopeful that 
they’d need no additional help! 
A useful resource. 


Score 


structures that underlie network 

traffic, then practical approaches 

to more difficult traffic capture, 

and a more detailed look at packet 

analysis, and some achievable 
reverse engineering. 

Now you’ re ready to find 
(and even exploit) some 
vulnerabilities, with practical 
chapters using .NET Core. The 

chapter on network protocol 
security should give you a fresh 
appreciation of cryptography, 
and re-implementing them (in 
Java or C this time) may leave 
you nervous of trusting anything 
that you receive — time to dive into 
the root causes of vulnerabilities 
and gain a much better 
understanding not just of these but, 
thanks to Forshaw’s examples, a 
better practical understanding of 
many aspects of code execution. 
Challenging in many ways, and 
rewarding in equal measure. 


Score 
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ELEGANT SCIPY with NumPy’s N-dimensional 


Authors: Juan Nunez-lglesias, 
Stefan van der Walt 

& Harriet Dashnow 

Publisher: O'Reilly 

Price: £31.99 

ISBN: 978-1491922873 
magpi.cc/2GCajjp 


SciPy, NumPy, 
Pandas, and scikit-image 

give not just the data scientist, 
but biologists and other users 
of image and signal processing, 
almost everything they need to 


do great work. Something that we 


may have mentioned in previous 
reviews here. This book is not 
just about the tools and how to 
use them — but how to use them 
with code that is clear, concise, 
and efficient. 

Along the way, this enjoyable 
and occasionally entertaining 
euide revels in the joy of elegant 
code, whilst demonstrating 
quite practical examples across 
a range of sciences — starting 


DOCKER FOR 


DATA SCIENCE 


Author: Joshua Cook 
Publisher: Apress 
Price: £19.99 

ISBN: 978-1484230114 
magpi.cc/2GDzcjs 


A book straddling 
many fields - 
aiming to teach 
Docker and its ecosystem, but 
using the field of data science 
throughout. Jupyter Notebook 
Server is the tool of choice, and 
a Jupyter/SciPy image on AWS. 
Docker and Jupyter are then 
brought together — first with an 
example program in C. 

That done, we jump forward 
30 years to [Python and NumPy, 
and spend the rest of the book 
more comfortably programming 
interactively in Python. Jupyter 
and Docker alternate as the 
main focus, meaning you get 
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Jani hi 


arrays with genome data, then 
sticking with the gene 
expression data, and 
moving on to quantile 
normalisation, then 
images as NumPy arrays. 
Fast Fourier Transform 
with SciPy takes in 
birdsong, moon landing 
pictures, and radar data; 
the three authors ensure 
a diversity of examples, yet write 
with a unity of purpose and even 
humour. Chapters on sparse 
matrix problems and linear 
algebra present several exercises 
for you to stretch the SciPy skills 
you’ve gained so far, and the 
chance to consider PageRank’s 
usefulness in examining 
ecosystems. The Toolz streaming 
library for large data sets 
rounds off a genuinely essential 
introduction to SciPy. 


Score 


just enough of each, rather than 
the in-depth look at SciPy in the 
O’Reilly book reviewed above. If 
you need both depth and 
breadth, start with this 
one. Following on from data 
persistence with PostgreSQL, 
the chapter on Docker 


applications) brings in 
examples with Redis, and with 
MongoDB, as well as scaling to 
larger AWS instances. 
Cook is an experienced teacher, 


with multiple interests and a clear 


style — all of which enables him to 
pull off the tricky juggling act of 
helping you to overcome Python- 
based data science challenges in 
the ‘infrastructure as code’ world 
without this once seeming to bea 
book designed to squeeze as many 
hot topics in as possible. Quite 

an achievement! 


Score 


Compose (for multi-container 


ESSENTIAL READING: 


GO LEARNING 


Not yet a decade old, Google’s concurrency- 
friendly, typed language is not one you can ignore. 


Go In Action 


Authors: William Kennedy, 
Brian Ketelsen & Erik St. Martin 
Publisher: Manning 

Price: £27.99 

ISBN: 978-1617291784 
magpi.cc/2GEBboo 


Gives you the why as well as the how, 
for real understanding in addition to 
practical knowledge - and is very 
good on concurrency. 


Go In Practice 


Authors: Matt Butcher & Matt Farina 
Publisher: Manning 

Price: £27.99 

ISBN: 978-1633430075 
magpi.cc/2vjoJBA 


Excellent cookbook-style collection of Go 
recipes that will enlighten you on Go, as 
well as solving your practical problems. 


The Little Go Book 


Author: Karl Seguin 
Publisher: OpenMyMind.net 
Price: Free download 
magpi.cc/2GyAbBE 


Ashort, CC-licensed introduction; if 
you're a developer looking for a quick 
start, this will get you up and running. 


Go Web Programming 


Author: Sau Sheong Chang 
Publisher: Manning 

Price: £27.99 

ISBN: 978-1617292569 
magpi.cc/2foFFga 


You may be surprised to hear that Go is 
good for writing web apps; after reading 
this book you'll be convinced. 


The Go Programming 
Language ss 
Author: Alan A. A. Donovan 


& Brian Kernighan 
Publisher: Addison-Wesley 


Price: £29.99 —— 
ISBN: 978-0134190440 
gopLio ave | " 


Not quite a K&R for Go, but this is an ite 
essential and practical guide to really 
learning the language in depth. 
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only at BuildPiper.com 


‘It’s a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mii ® 
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INTERVIEW 


Community 
MARINE SCIENCE WITH 


RASPBERRY PI 


Monitoring mussels and how 
humans affect their environment 
turned out to bea job for the 
Raspberry Pi 


Occupation: Environmental Engineer 


e like seeing the Raspberry 
Pi used for science, so 
when Jonathan approached 
us about how he’d been using 

Pi Zeros to study mussels for 

his masters thesis, we were 
immediately intrigued. Jonathan 

is a great lover of nature, and is an 
avid nature photographer as well 
as environmental scientist. 


Can you tell us about your 
masters project? 

Last summer I wrote my master 
thesis with the goal to create a 
battery-powered biological sensor 
system (a biosensor) that can 
monitor water quality. For this 
project I connected blue mussels 
(Mytilus edulis) to a Raspberry Pi 
Zero to monitor their movement. 
The project was very successful. 


MagPi March 2018 


PP PEdGDddee 5 
er te 
Pe 
i ype 
sub 


Why use the Raspberry Pi? 

Since the Zero is cheap, uses 
little energy, and can easily be 
programmed with Python, it was 
the perfect match for this project. 


What have you used the Raspberry 
Pi for in the past? 

I have used the Raspberry Pi 

to control wireless cameras 

for monitoring purposes in 
hazardous environments. I have 
also used Raspberry Pi boards to 
control viewing screens at the 

local university. 


What kind of results did you get? 
The experiments showed that blue 
mussels’ behaviour (valve gape 
movement) is altered by physical 
Stimuli such as light, temperature, 
and access to food. The blue 


mussels are most active during 
night-time when it is less light. 
The biosensor system based on the 
Raspberry Pi proved very robust 
and reliable for this project. 


Would you use a Raspberry Pi 
setup again? 

I am planning to use the Raspberry 
Pi in a lot of future projects! 


Above The cage that the mussels were 
kept in was submerged in water so they 
could be studied in their natural habitat 
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aspberry Jams are great, but 

what if you can’t attend one? 

York Pi Jam has found a way 
around that by offering an online 
Raspberry Jam (virtual.yorkpi.tech) 
that gives out tasks to its members. 
They have to complete a project ina 
week — like in a traditional game jam 
— and while prizes are given out, fun 
is the name of the game. 


Can you tell us about the 

Virtual Jam: 

A Virtual Pi Jam is an opportunity 
for people who have no knowledge 
in coding to have a go. We supply 
them with tutorials for Scratch, 
Python, HTML, etc. They have a 
weekend or a whole week to create 

a project and then submit it. The 
submissions then get judged and 
the winners get prizes. These 

prizes come from companies such 
aS ModMyPi who have helped 
massively with the Virtual Pi Jams. 
The Virtual Pi Jams also allow people 
who have no local Raspberry Pi Jams 
to join in. 
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The winner 
of the joke-themed 
Jam created an 
entire website 
filled with jokes 


Why did you decide to start a 
Raspberry Jam: 

There was a blog post on the 
Raspberry Pi website about starting 
new Jams and the idea intrigued 
me. Also, the fact that there wasn’t 
really a Code Club at my school and 
I wanted to get people into physical 
computing and programming and 
give them the same opportunities I 
have had. 


Why virtual? 

Again, it gives such a massive 
opportunity for schools and 
individual groups to get involved and 
have a chance to win prizes. From 
this we have seen websites, coded 
traffic lights, and games on the 
Sense HAT. Not only does it allow 
Opportunities, but also a chance 
for people with no knowledge or 
local jams to get involved. We also 
do love to see projects from coders 
with knowledge. 


Cra bem" 


ee ae ae | 
Ae eee a J ees 


Houses of Dilaritica 


os he BH Le as he ee 


How many people attend the Jam? 
In our December Jam, for which we 
had the theme of ‘Lost In Space’, 
we had people submitting from five 
different countries including the 
USA, UK, and France. We also had 

a different range of groups taking 
part. Some were schools, some 
were friends. We roughly had 100 
submissions that were whittled 
down so we could give out the prizes 
of £10 ModMyPi gift cards, some 
ModMyPi goody bags including some 
Pi cases and Haribos, and alsoa 
Devslopes Life Time Access Pass. 


What sort of feedback have people 
given you about the Jam? 

People are liking the fact that it has 
no geographical restrictions and 
there is no ‘selling out’. Also, the 
fact we supply resources and by 
including prizes we are encouraging 
more people to get coding. It is great 
hearing feedback! 


Would you ever consider doing the 
Jam in real life? 

Iam actually planning a real-life 
Jam for 24 March in York. We will be 
having some small workshops and it 
should hopefully be a great day. 


What’s been your favourite 
moment holding the Jams so far? 
Getting to see the projects based on 
the monthly themes we set. Also, 
when people tweet us pictures of 
their prizes arriving by post, it is 
amazing. It is really fun. 
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THE MONTHIN 


Everything else that happened this month in the world of Raspberry Pi 
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Jams that signed before the deadline last month 
also got a special kit for their event, including 


copies of The MagPi as well as an excellent T-shirt 
to commemorate the event. Make sure you get any 


free swag you can from your Jam. 
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f you’re reading this when the magazine comes 

out, it won’t be long until Raspberry Pi turns six 

years old! To celebrate, over 100 Raspberry Jams 
are taking place around the world on Saturday 3 and 
Sunday 4 March. The list of Jams is still slowly growing 
and probably will continue to do so until the Birthday 
Weekend, so if you can’t see one close to you on the list, 
keep checking to see if one is added. 

Ben Nuttall, Raspberry Pi Community Manager, has 
this to say about the Birthday Jams: 

“We’re really looking forward to celebrating our 
birthday with thousands of people around the world. 
Over 48 hours, people of all ages will come together at 
more than 100 events to learn, share ideas, meet people, 
and make things during our Big Birthday Weekend. 

“Since we released the first Raspberry Pi in 2012, 
we’ve sold 17 million of them. We’re also reaching 
almost 200000 children in 130 countries around the 
world through Code Club and CoderDojo, we’ve trained 
over 1500 Raspberry Pi Certified Educators, and we’ve 
sent code written by more than 6800 children into 
Space. Our magazines are read by a quarter of a million 
people, and millions more use our free online learning 
resources. There’s plenty to celebrate and even more 
still to do: we really hope you’!l join us from a Jam near 
you on 3-4 March.” 
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Big Birthday Weekend 


Ahmedabad, India 

Amsterdam, Netherlands 

Attard, Malta 

Bedfordshire, UK 

Belfast, UK 

Bletchley, UK 

Bogota, Colombia 

Budapest, Hungary 

Cagliari, Italy 

California, USA 

California, USA 

California, USA 

Cape Town, South Africa 

Cebu, Philippines 

Chelmsford, UK 

Cheltenham, UK 

Chennai, india 

Chennai, India 

Chennai, India 

Cheshire, UK 

Chhattisgarh, India 

Chidambaram, India 

Cornwall, UK 

Cumbria, UK 

Delhi, India 

Devon, UK 

Dorset, UK 

East Sussex, UK 

East Yorkshire, UK 

Ecatepec, Mexico 

Essex, UK 

Florida, USA 

Florida, USA 

Forst, Germany 

Georgia, USA 

Glenunga, Australia 
School Raspberry Jam 

Granada, Spain 

Greenwich, UK 
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Gujarat, India BSeraeeelel-tiava merle 


Hamamatsu, Japan 
Hamamatsu 2018 

Indore, India 

Isfahan, Iran 

Istanbul, Turkey 

Kanpur Nagar, India 

Kent, UK 

Kerala, India 


Kisii, Kenya 

Raspberry Jam 
Lancashire, UK 
Lancashire, UK 
Lima, Peru 
Limerick, Ireland 
London, UK 
London, UK 


London, UK 
Birthday Party 

Manchester, UK 

Maryland, USA 

Maryland, USA 

Masvingo, Zimbabwe 

Mazandaran, Iran 

Michigan, USA 

Michigan, USA 

Montréal, Canada 

Mumbai, India 

New York, USA 


New York, USA [Bi iinteltelanr-tae-ler-wan <lasiavencela 
Raspberry Jam 


North Carolina, USA 
Nottingham, UK 


Nottinghamshire, UK )seele-isyeeyan 
@ Worksop College 


Odisha, India 

Oklahoma, USA 

Ontario, Canada 

Ontario, Canada 
Ontario, Canada 

Oxford, UK 
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Big Birthday 
y Weekend 


3-4 
March 
2018 


3 March 


2018 


4 March 


2018 


Paris, France 

Penang, Malaysia 
Pennsylvania, USA 
Pennsylvania, USA 
Perth, Australia 

Saverne, France 
Scotland, UK 
Scotland, UK 


Somerset, UK 
Weekend Jam 

Somogy, Hungary 

Sucre, Bolivia 

Tapel Taiwan 

Terni, Italy 

Texas, USA 

Texas, USA 

Texas, USA 

Tokyo, Japan 

Tyne and Wear, UK 

Tyne and Wear, UK 

Tyrone, UK 


WEldar-pu=iellet-let-ms Varna Raspberry Jam Big Birthday 
Weekend 2018 


Vest-Agder, Norway 
Virginia, USA 

Voi, Kenya 

Wales, UK 

Wales, UK 

Wales, UK 

Washington, USA 
Washington, USA 

West Midlands, UK 
West Sussex, UK 
West Virginia, USA 
West Yorkshire, UK 
West Yorkshire, UK 
West Yorkshire, UK 
Wiltshire, UK 
Wisconsin, USA 

Yaoundé, Cameroon 
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Al BETT 2018 


The annual education fair showcases 
new and upcoming teaching tech 


ince 2014, Raspberry Pi 

has been attending Bett 

— an annual educational 
technology trade show — to show 
off all the free resources and 
teacher training programmes that 
the Foundation offers. 

“Our setup this year consisted 
of four pods (imagine beefed up 
tables) in the STEAM village, and 
the mission of our highly trained 
team of education agents was 
to establish a new world record 
for highest number of teachers 
talked to in a four-day period,” 
wrote Dan Fisher, Raspberry Pi 
Foundation Project Co-ordinator, 
in a blog post. “I’m only 
half-joking.” 

You can read his full report 
on the Raspberry Pi blog 
(magpi.cc/2EC33L4), but suffice The Raspberry Pi setup won Best 

; Hands-On Experience, a great win 
to say it was a great weekend for for the hard-working Bett team 
promoting digital making. 
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This has been captioned 
‘educators with a mission’, 
but we prefer ‘STEAM Angels’ 


7 
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Hello World is our educational sister magazine, seen 
here with American Raspberry Pi Certified Educator 
and all-round nice bloke Nick Provenzano (left) 
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CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


NANOSOUND DIGITAL 


A follow-up to the NanoSound DAC Pro which we 
reviewed in a previous issue, the Digital version 
provides the same excellent setup while also letting 
you connect with S/PDIF. There’s also a complete 
music-streaming box kit that will be funded with the 
new campaign, along with software updates. If you 
like using your Raspberry Pi as a music player, we 
recommend giving it a look! 


VICTORIAN 
MAGIC 


I2C METAL DETECTOR (eee 


Magic mirrors are 
cool, but what is 
cooler is making the 


mirror section of a 
Victorian dresser into 

a magic mirror. It's 
almost steampunky 

- perhaps adding a 
Nixie tube aesthetic 

to the display would 
make it seem truly old? 
We love it anyway. 


We’ve been around the block with the cool and 
amazing Raspberry Pi projects that people in the 
community have made, but can’t recall encountering 
any metal detectors — apart from the Discoverer robot 
featured in issue 48. This component might just help 
kickstart a movement of metal-detector projects. For 
people in the know, it uses a AD5933, a high-precision 
impedance converter which contains a Sine Wave 
DDS (direct digital synthesis) Generator from 1kHz 

to 100 kHz. Hopefully those are magic words to the 
coin, joeeyole. 
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EVENT CALENDAR 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


DALLAS 
RASPBERRY JAM 
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Want a Raspberry Jam in g/ © & 7) OS 


your area? Want to start one? 
Email Ben Nuttall about it: 
ben@raspberrypi.org 


5 PATRIOT Pl JAM a, ® 
@ JAP PI JAM 


JAP PI JAM 

When: Thursday 1 March 

Where: MAM College of 
Engineering and 
Technology, Trichy, India 

magpi.cc/2EyZ2qS 

A great way to find out more about 

the Pi, learn what you can do with 

it, and meet like-minded people. 


DALLAS RASPBERRY JAM 

When: Saturday 10 March 

Where: Perot Museum of Nature 
and Science, Dallas, TX, USA 

magpi.cc/2EDZB2u 

A Raspberry Jam post-birthday 

celebration. Discover amazing 

gadgets and gizmos throughout the 

museum, and learn about coding. 
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OTTAWA JAM 

When: Saturday 10 March 

Where: Canada Science and 
Technology Museum, 
Ottawa, Ontario, Canada 

magpi.cc/2EAFimz 

Get your digits and neurons moving 

with hands-on coding and discover 

projects created by local tinkerers. 


SHEFFIELD RASPBERRY JAM 

When: Thursday 15 March 

Where: Hertha Ayrton STEM Centre, 
Sheffield, UK 

magpi.cc/2ExT89z 

If you’ve built an interesting Pi 

project, bring it along and share it 

with the community for the chance 

to win an exciting prize. 


PATRIOT PI JAM 

When: Saturday 17 March 

Where: Cherry Valley-Springfield 
Central School District, 
Cherry Valley, NY, USA 

magpi.cc/2ED5MUy 

Celebrate making with the Raspberry 

Pi at CV-S’s first ever Jam. Come 

empty-handed or bring your own Pi. 


YORK PI JAM FOR BEGINNERS 

When: Saturday 24 March 

Where: Robert Wilkinson Primary 
Academy, West End, York, UK 

mMagpi.cc/2spChAL 

A Raspberry Pi Jam for beginners, 

allowing them to learn more about 

the Raspberry Pi at this family- 

friendly event. 
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LONDON 
RASPBERRY PINT 


REGULAR EVENTS 


PRESTON RASPBERRY JAM 

When: Monday 5 February 

Where: Media Factory Building, 
Preston, UK 

magpi.cc/2EDf{NBk 

A community of people who meet 

in Preston each month to learn, 

create, and share the potential of 

the Raspberry Pi. 


LONDON RASPBERRY PINT 
When: Tuesday 27 March 

Where: CodeNode, London, UK 
magpi.cc/2swMPhN 

Got a Raspberry Pi project 
you’re working one Show it 

off or get advice from others 

at Raspberry Pint, one of a 
number of capital events. 
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BIG BIRTHDAY 
WEEKEND 


WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 
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RASPBERRY JAM 


Raspberry Pi turns six this year and 
to celebrate this, the Raspberry Pi 
Foundation is co-ordinating a huge 
number of Jams around the world 

to participate in the Big Birthday 
Weekend. There are over 100 Jams 
co-ordinating events on Saturday 

3 March (and a few on Sunday 4 
March). You can read more about them 
- including an up-to-date list! - in This 
Month in Raspberry Pi, on page 88. 
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LETTERS 


BIRTHDAY PARTY 


It’s great you’ve managed to find a 
local Jam to go to! The Big Birthday 
Weekend has been a great way to 
get people to come together and 
celebrate the Raspberry Pi without 


I’m excited to be attending a 
Big Birthday Weekend Jam near 
me in March — I’ve not been 
able to come to the last two 
Cambridge-based 


birthday parties, having to travel 
so I’m happy that *R A SP B E R R Y to Cambridge 
this year I’ll be and try to get 
able to celebrate one of the 
the birthday of limited tickets. 
Raspberry Pi with That being said, 
other people! "there will be a big, 
I was just 4g official event in 
wondering, , Cambridge held by 
though, will ‘ » Raspberry Pi this 
there be a normal ’ summer. We don’t 
birthday party like the have many details 


last two years? I’ve not seen 
any info on it. I loved looking 

at the pictures of the last one 
and hearing about the cool stuff 
that went on. Either way, happy 
birthday to the Raspberry Pi! 
Beth 


I’ve recently been getting into 
wearables, making little light- 
up badges and patterns on old 
clothes I had. It’s been really 
fun, but I wanted to expand what 
I did with wearables. Would the 
Raspberry Pi be suitable for this? 
What Raspberry Pi would be best 
for a wearable, do you think? 

Lee 


We’ve successfully used the 
Raspberry Pi for wearables in the 
past — even as far as using it for 
complex cosplay electronics! As 
the Raspberry Pi is nice and easy to 
program, with plenty of tutorials 
online on how to hook up 


on it yet, other than it will be 

the weekend of 30 June — 1 July. 
Hopefully it means the weather 
will be a bit better! We’1l definitely 
try to get there as well, so you’1l 
have another chance to meet 

The MagPi team. 


electronics to it, it can be quite 
quick to set up your own custom 
wearable using one. 

Other wearable makers and 
cosplayers may warn that the 
Raspberry Pi can draw a bit more 
power than other microcontrollers 
like Arduino. However, we’ve never 
experienced a problem with not 
having enough power to last fora 
significant amount of time. 

As for what Raspberry Pi model 
we recommend — the Pi Zero is the 
natural choice for wearables due 
to its size. However, if you have 
the space, an A+ or even a full-size 
Raspberry Pi 3 will do the trick as 
they’re still very small. 
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FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving 
for the community — join in via 
raspberrypi.org/forums 


he piece on making a text adventure in , 

The MagPi #64 reminded me of the game __ The simple way to mount your P'! 

‘Hampstead’ on the ZX Spectrum. What 
makes that game stick in my mind is that it is a 
Satirical game about social climbing (a typically 
British hang-up). Hampstead is an expensive 


- Industrial DIN rail mount 


London suburb. But in this game you can’t just - Open frame for better airflow 
go to Hampstead and buy a house there: you . Integ rated USB strain relief 


have to ‘attain Hampstead’. This you accomplish 
— as far as I remember — by marrying the boss’s 
daughter, among other things. 

I bring this up to illustrate the point that 
it is not the sophistication of the technology 
that makes a game immortal (or we wouldn't 
mess with retro games), but the wit of the 
game’s designers. 


geoffreymh 


We fully agree — while games are generally more 
complex these days due to advancements in both 
the technology we play them on and the ease 
with which games can be developed, a good story 
and a good idea is timeless, whether it’s a simple 
text adventure, a ZX Spectrum game with limited 
colours, or a full-on VR experience. 

Hopefully, the tutorial from issue 64 will show 
people just how simple they can start with game 
making, and work from there to make their 
magnum opus, whatever form it might take. 
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START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


“We use Code Club's fun educational resources to runa 
weekly after-school club for Year 7 and Year 8 pupils. The 
students benefit considerably from the extra challenge!” 


Karen Dadd, Computing Teacher 


[A Code Club is free 
M4 Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


4 Code Club helps children develop skills including 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us! 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 65 


IN ASSOCIATION WITH: 


PROJECTS 


“This project lets you build an image-recognition Learn more: 
device that can see and identify objects, powered : : i 
by TensorFlow’s machine learning models.” alyprojects.withgoogle.com 


is the amazing — a | 
cardboard kit from that enables tt 
you to build an intelligent camera. . 
10 lucky winners will get a complete 
ATY Projects Vision Kit. 


VisionBonnet accessory board 
24mm RGB arcade button 


and nut 

Privacy LED 

Piezo buzzer 

Cardboard box and frame 


Put everything together in the kit 
to build an intelligent camera 


Terms & Conditions 


Competition opens on 21 February 2018 and closes on 29 March 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the 
Raspberry Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering 
the competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and 


no cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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mpowering young people with technology 
is a big part of what we do at the Raspberry 
Pi Foundation. In order to do that, we make 
computers as affordable as we possibly can. We also 
train educators for free and provide free content for 
them to teach digital making during the school day. 
However, providing the opportunity for young 
people to learn about computers after school and on 
weekends is just as critical. They can use technology 
to explore their interests and passions, whether 
that’s solving a problem, making a game, expressing 
themselves creatively, or just having fun. 
This is why the Raspberry Pi Foundation supports 
Code Club and CoderDojo. Both programs take 


MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


MAKING AN 
f IMPACT OUTSIDE 
* THE CLASSROOM 


A growing after-school movement provides more opportunities 
for young people to learn tech. Matt Richardson explains 


Youth can create games, phone apps, websites, 
or even dip into physical computing. 

An important aspect of these after-school 
programs is that they’re an opportunity for the youth 
to learn in a self-directed manner. They can zip 
ahead or take it at an easy pace. If there’s something 
they want to experiment with or get creative with, 
they can take a detour. 


Different reasons 

A young person may have different motivations 

for being at a Code Club or Dojo. Some may want to 

develop solutions to address real-world problems 

in their home or community. Some may want to 
create games; others to use code 


We want this movement to be to express themselves creatively. 


What’s important is that the youth 


accessible to all young people are doing something they want to 


and we need your help 


place outside of school time and provide young 
people with the opportunity to explore and create 
with technology. 

Code Clubs are for 9- to 13-year-olds and typically 
take place once a week for an hour at school, but after 
the end of the school day. We provide educators the 
content, structure, and volunteer matching so that their 
students can learn computational thinking with Scratch, 
make games or websites, and have fun at the same time. 

A Dojo is for 7- to 17-year-olds and takes place in 
the evenings or on the weekends. They’re typically 
hosted at community centres, libraries, universities, 
and corporate offices. CoderDojo is an opportunity 
for young people to create their own projects with 
technology with the help of volunteer mentors. 
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do, and not something that they’re 

assigned to do. 

Unlike in the classroom, a club isn’t 
rigorous environment. There are no tests, reports, 
or papers. It’s an opportunity to create, learn, 
collaborate, and share without pressure. I know from 
my own personal experience that not all youth thrive 
in the classroom, but can really shine in a more 
informal environment where they can explore their 
own passions. 

We want this movement to be accessible to all 
young people and we need your help to make that 
happen. You can attend a local club with your kids, 
volunteer as a mentor, or encourage your local school 
or library to start one up. You can even Start your own 
club for your community. Let’s work together to put 
the power and potential of digital making into the 
hands of all young people, all over the world. 
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THE Official 
RASPBERRY PI 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adaptors 

8GB Micro SD card 

116-page beginner’s book 
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store.rpipress.cc 
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A Wiley Brand 
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Build your own credit card 
sized computer 


Get started with programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pi board and case 
Power supply and HDMI cable 
Pre-Programmed Memory Card 
Over 49 electronic Parts 
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FOR 


DUMMIE 


Available in Europe 
Available for worldwide shipping at: through RS Components 


$389” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd, Canakit is a registered 
trademark of Cana Kit Corporation. 
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